<< Click to Display Table of Contents >>

Navigation:  Using SyncBackPro > Technical Reference > Scripting >


Previous pageReturn to chapter overviewNext page


A number of constants are available.




The following are location abilities. Note that some of these cannot be returned by LocAbilities:


CAN_WINDOWSFOLDERS = Does the location use Windows folders? Cannot be used by LocAbilities()

CAN_COPYDIRATTRS = Can the directory attributes and date & times be copied to a new directory? Cannot be used by LocAbilities()

CAN_COPYSECURITY = Can the file/folder NTFS security be copied? Cannot be used by LocAbilities()

CAN_USEBACKUPAPI = Can the BackupRead/BackupWrite API's be used? Cannot be used by LocAbilities()

CAN_USEMD5 = Can use MD5 hashing? This is used for verification and file integrity checking.

CAN_USEATTRIBUTES = Do files/folders have Windows attributes? See also CAN_NTFSATTRIBUTES

CAN_EXACTDATETIME = Are dates & times stored exactly (including milli-seconds)?

CAN_CHANGEATTRIBUTES = Legacy scripts may use it but will be converted to CAN_CHANGE_FILEATTRS + CAN_CHANGE_FOLDERATTRS

CAN_CHANGEDATETIME = Can file/folder date & times be changed?

CAN_SINGLEZIP = Are all the files stored in a single Zip file? Cannot be used by LocAbilities()

CAN_HAVEEMPTYPATH = Can the base path be empty?

CAN_STOREDONWINDOWS = Is the location on a Windows filesystem? e.g. a drive or UNC path. Cannot be used by LocAbilities()

CAN_VERSION = Does the location support versioning?

CAN_DIRECTACCESS = Are files stored on a Windows filesystem uncompressed etc? Cannot be used by LocAbilities()

CAN_NTFSATTRIBUTES = Files & folders have NTFS extended attributes?

CAN_WRITEONCE = Write-once, meaning cannot read from it only write to it, e.g. split zip

CAN_MOVE_FILES = Can files be moved/renamed?

CAN_USECRC32 = Can use CRC32 hashing?

CAN_MOVE_FOLDERS = Can folders be moved/renamed?

CAN_PREFERRED_FILECASE = It is better to use the case of files on this location

CAN_PREFERRED_FOLDERCASE = It is better to use the case of folders on this location

CAN_CANNOT_COPYTO = Files cannot be copied to this location, but can be deleted from it, e.g. backup of email

CAN_VIRTUALFOLDERS = Folders are virtual and not real so they should not be created, deleted, or renamed, e.g. cloud

CAN_RESUME_TRANSFER = Can the location resume a broken file transfer if the profile is run again?

CAN_CHANGE_FILEATTRS = Can file attributes be changed?

CAN_CHANGE_FOLDERATTRS = Can folder attributes be changed?

CAN_CHANGE_CACHEDSIZE = Can file size be changed? Cloud only. This is used with cloud caching. Cannot be used by LocAbilities()

CAN_CHANGE_CACHEDHASH = Can file hash be changed? Cloud only. This is used with cloud caching. Cannot be used by LocAbilities()

CAN_USESHA1 = Can use SHA1 hashing? This is used for verification and file integrity checking.

CAN_USESHA256 = Can use SHA256 hashing? This is used for verification and file integrity comparison.





The following are the reasons why a profile was aborted:


EAR_User = User chose to stop this profile

EAR_Timeup = Profile has run out of time (ELR_TimeLimit)

EAR_ProgramClose = SyncBack is closing

EAR_StopAllProfiles = User wants to stop all the profiles

EAR_WindowsShutdown = Profiles are stopping because of Windows shutdown

EAR_StoppingGroup = Stopping because it's part of a group that is being stopped

EAR_Script = Aborted by a script

EAR_TooManyDeletes = Too many files will be deleted (ELR_TooManyDeletes)

EAR_TooManyUpdates = Too many files will be updated (ELR_TooManyUpdated)

EAR_AlreadyRunning = The profile was already running

EAR_UserOther = User chose to stop this profile (from another process)

EAR_TouchLicensing = Too many SyncBack Touch servers being used (ELR_TouchLicensing)





The following are actions that can be performed on files and folders (note that many of these cannot be used with folders):


CACTION_ERROR = Skip the file - there was an error

CACTION_SKIP_ONCE_UPD = Do nothing, skip/ignore the file. SmartSync data is updated.

CACTION_COPY_TOSOURCE = Copy from destination to the source

CACTION_COPY_TODEST = Copy from source to the destination

CACTION_DELSOURCE = Delete from source

CACTION_DELDEST = Delete from destination

CACTION_DELBOTH = Delete source & destination

CACTION_MISSING_PROMPT = A file is in source or destination, but not both, prompt the user

CACTION_DETAILS_PROMPT = Contents same, but attributes and/or date & time changed, prompt the user

CACTION_BOTH_PROMPT = The file has changed in both, prompt the user

CACTION_USE_SRC_DETAILS = Use the file attributes, security, filename case, and/or date & time from the source

CACTION_USE_DEST_DETAILS = Use the file attributes, security, filename case, and/or date & time from the destination

CACTION_MOVE_TOSOURCE = Move from destination to the source

CACTION_MOVE_TODEST = Move from source to the destination

CACTION_UNCHANGED = The file is actually unchanged (for Fast Backup only)

CACTION_RENAME_SOURCE = Rename the source file (for SmartSync only when FILES HAVE BEEN RENAMED)

CACTION_RENAME_DEST = Rename the destination file (for SmartSync only when FILES HAVE BEEN RENAMED)

CACTION_SKIP_ALWAYS = Same as CACTION_SKIP_ONCE_NOUPD except selections updated so file is unselected

CACTION_SKIP_ONCE_NOUPD = Do nothing, skip/ignore the file. SmartSync/Cloud database is NOT updated.





The following are profile backup types:


ERBT_Unknown = Unknown

ERBT_Full = Full

ERBT_Incremental = Incremental

ERBT_Differential = Differential





The following are cloud service types:


ECT_Unknown = Unknown

ECT_S3 = Amazon S3 or compatible, e.g. Google Storage

ECT_Azure = Microsoft Azure or compatible

ECT_Dropbox = Dropbox

ECT_GDrive = Google Drive

ECT_SkyDrive = Microsoft OneDrive (personal)

ECT_Box = Box

ECT_CloudDrive = Amazon Drive

ECT_SugarSync = SugarSync

ECT_Office365 = Sharepoint and OneDrive for Business

ECT_Rackspace = Rackspace/Openstack

ECT_Backblaze = Backblaze

ECT_GoogleStorage = Google Storage

ECT_hubiC = hubiC (Openstack)






The following are differences. Note that the values can be or'ed together if there is more than one difference:


CDIFF_IDENTICAL = Skipped because of settings or files are identical

CDIFF_SIZE = Different sizes, does not apply to directories

CDIFF_HASH = Different hash values, does not apply to directories

CDIFF_MODDATETIME = Different modification date & time

CDIFF_DESTONLY = In destination only

CDIFF_SRCONLY = In source only

CDIFF_ATTRIB = Different attributes

CDIFF_VERSION = Only the versions exist (will show in Differences window), does not apply to directories

CDIFF_CASE = File case is different

CDIFF_CREATEDATETIME = Different creation date & time

CDIFF_NTFSSEC = Different NTFS security





The following are exact profile types:


EPTError = Error

EPTUnknown = Unknown profile type

EPTCustom = Custom

EPTBackupFromSrc = Backup from source to destination

EPTBackupFromDest = Backup from destination to source

EPTOldSync = Basic Sync

EPTSync = Intelligent Sync

EPTGroup = Group

EPTMirrorRight = Mirror from source to destination

EPTMirrorLeft = Mirror from destination to source





The following are standard Windows file attributes:
























The following are reasons why a file or folder is ignored:


EIRUnknown = Unknown

EIRNotSelected = Not selected in folder & file selectin tree

EIRDoesNotExist = File/folder does not exist

EIRJunctionPoint = Is a junction point and settings say they are to be ignored

EIRNewFolder = A new folder and parent folder settings say new folders are to be ignored

EIRNewFile = A new file and parent folder settings say new files are to be ignored

EIRFiltered = Filtered out due to filter settings

EIRNotZipFile = File is not a Zip file (when multi-zip and a non-zip file is found)

EIRError = Skipped due to error

EIRNotModifiedWithin = Wasn't modified within the required time

EIRSizeOutOfBounds = File size is too small or too large

EIRIdentical = The source & destination file are the same

EIRAdvancedSetting = Many reasons, e.g. in destination but not source

EIRNotOldEnoughToDelete = Old file (only in source or dest) not deleted as it's not old enough

EIRCannotModifySource = Source cannot be modified, e.g. Fast Backup

EIROtherFileNewer = The destination file is newer so cannot be replaced

EIRCannotReplaceReadOnly = The destination file is read-only so cannot be replaced

EIRCannotDelReadOnly = The destination file is read-only so cannot be deleted

EIRCannotMoveCopyReadOnly = Source is read-only so cannot be copied

EIRCannotMoveCopyNotAttrib = Source file does not have archive attribute set so cannot be copied

EIRCannotMoveCopyHidden = Source file has hidden attribute set so cannot be copied

EIRCannotMoveCopySystem = Source file has system attribute set so cannot be copied

EIRDST = Not copied due to DST time difference

EIRSameSize = Files same size

EIRScript = Ignored by script

EIRCannotMoveCopyOffline = Source file has offline attribute set so cannot be copied

EIRCannotMoveCopyEncrypted = Source file has encrypted attribute set so cannot be copied

EIRCannotModifyDest = Destination cannot be modified

EIRSameTime = Files same date & time

EIRReplacingWithEmpty = Trying to replace a non-empty file with an empty file

EIRNotCreatedWithin = Wasn't created within the required time





The following are profile types:


ptInvalid = Invalid profile type

ptProfile = Normal profile

ptGroup = Group profile





The following are profile run results:


ELR_None = No result

ELR_UnknownProfile = Unknown profile

ELR_AlreadyRunning = Profile is already running

ELR_Imported = Profile has been imported and not run yet

ELR_Running = Profile is running

ELR_InternalError = Internal error

ELR_SimAborted = Simulated run was aborted

ELR_SimFailed = Simulated run failed

ELR_SimSuccess = Simulated run was a success

ELR_RestAborted = Restore was aborted

ELR_RestFailed = Restore failed

ELR_RestSuccess = Restore was a success

ELR_Aborted = Run was aborted

ELR_Failed = Run failed

ELR_Success = Run was a success

ELR_NetFailed = Failed due to network connection

ELR_ScanFailed = Failed because left or right could not be scanned

ELR_CompFailed = Failed because the left and right could not be compared

ELR_RunBeforeFailed = Run failed because Run Before program stopped profile

ELR_Disabled = Run failed because profile is disabled

ELR_SMARTFailed = Run failed because drive errors were found

ELR_EmailFailed = Run failed because the log could not be emailed

ELR_SnapshotFailed = Run failed because the Volume Shadow Copy service failed

ELR_TimeLimit = Profile was aborted because it reached its run-time limit

ELR_TooManyDeletes = Profile was aborted because too many files would be deleted

ELR_TooManyUpdates = Profile was aborted because too many files would be updated

ELR_TouchLicensing = Profile was aborted because of Touch Licensing

ELR_IntegrityCheckAborted = Integrity check run was aborted

ELR_IntegrityCheckFailed = Integrity check run failed

ELR_IntegrityCheckSuccess = Integrity check run was a success

ELR_RansomwareProtection = Ransomware Protection





The following are file integrity types:


EIT_None = None

EIT_CRC32 = CRC32 hash value

EIT_MD5 = MD5 hash value

EIT_SHA1 = SHA1 hash value

EIT_SHA256 = SHA256 hash value

EIT_ETAG = Cloud ETAG value





The following are the versions of Windows:


wvUnknown = Unknown

wvWin2000 = Windows 2000 - 5.0 (build 2195) - not supported

wvWinXP = Windows XP - 5.1 (build 2600) - not supported

wvWin2003 = Windows 2003 - 5.2 (also 2003 R2, Home Server, and XP Pro x64) (build 3790) - not supported

wvVista = Windows Vista - 6.0 (build 6000..6002)

wvWindows2008 = Windows 2008 - 6.0 (build 6001..6002)

wvWindows7 = Windows 7 - 6.1 (build 7600..7601)

wvWindows2008R2 = Windows 2008 R2 - 6.1 (build 7600..7601)

wvWindows8 = Windows 8 - 6.2 (build 9200)

wvWindows2012 = Windows 2012 - 6.2 (build 9200)

wvWindows81 = Windows 8.1 - 6.3 (build 9600)

wvWindows2012R2 = Windows 2012 R2 - 6.3 (build 9600)

wvWindows10 = Windows 10 - 6.4

wvWindows2016 = Windows 2016 - 6.4






All Content: 2BrightSparks Pte Ltd © 2003-2019