Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

DirectoryWatcher.AddDirectory

Adds a directory to watch.

Component Version macOS Windows Linux Server iOS SDK
DirectoryWatcher 7.1 ❌ No ✅ Yes ❌ No ✅ Yes, on Windows ❌ No
MBS( "DirectoryWatcher.AddDirectory"; Watcher; Path; recursive; Action )   More

Parameters

Parameter Description Example
Watcher The watcher reference number. $watcher
Path The directory path to verify. "C:\Users\Administrator\Desktop"
recursive Whether to recursively check subdirectories.
Pass 1 to turn on or 0 to turn off.
1
Action The changes to monitor. "Filename¶DirName¶Attributes¶Size¶LastWrite¶LastAccess¶Creation¶Security"

Result

Returns OK or error.

Description

Adds a directory to watch.
With the actions you can define what changes to report.

ActionValueDescription
Filename1Any file name change in the watched directory or subtree causes a change notification wait operation to return. Changes include renaming, creating, or deleting a file name.
DirName2Any directory-name change in the watched directory or subtree causes a change notification wait operation to return. Changes include creating or deleting a directory.
Attributes4Any attribute change in the watched directory or subtree causes a change notification wait operation to return.
Size8Any file-size change in the watched directory or subtree causes a change notification wait operation to return. The operating system detects a change in file size only when the file is written to the disk. For operating systems that use extensive caching, detection occurs only when the cache is sufficiently flushed.
LastWrite16Any change to the last write-time of files in the watched directory or subtree causes a change notification wait operation to return. The operating system detects a change to the last write-time only when the file is written to the disk. For operating systems that use extensive caching, detection occurs only when the cache is sufficiently flushed.
LastAccess32Any change to the last access time of files in the watched directory or subtree causes a change notification wait operation to return.
Creation64Any change to the creation time of files in the watched directory or subtree causes a change notification wait operation to return.
Security256Any security-descriptor change in the watched directory or subtree causes a change notification wait operation to return.

Examples

Watch for changes in directory:

MBS("DirectoryWatcher.AddDirectory"; $Watcher; Directory Watcher::Directory; 1; "Filename¶DirName¶Attributes¶Size¶LastWrite¶LastAccess¶Creation¶Security")

Example Databases

This function checks for a license.

Created 5th March 2017, last changed 26th May 2017


Dictionary.Values - DirectoryWatcher.ChangeCount