Topics
All
MacOS
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Deprecated
Guides
Examples
Videos
New in version:
10.1
10.2
10.3
10.4
10.5
11.0
11.1
11.2
11.3
11.4
Statistic
FMM
Blog
Adds a directory to watch.
Component | Version | macOS | Windows | Linux | Server | iOS SDK |
DirectoryWatcher | 7.1 | ❌ No | ✅ Yes | ❌ No | ✅ Yes, on Windows | ❌ No |
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" |
Returns OK or error.
Action | Value | Description |
Filename | 1 | Any 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. |
DirName | 2 | Any directory-name change in the watched directory or subtree causes a change notification wait operation to return. Changes include creating or deleting a directory. |
Attributes | 4 | Any attribute change in the watched directory or subtree causes a change notification wait operation to return. |
Size | 8 | Any 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. |
LastWrite | 16 | Any 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. |
LastAccess | 32 | Any change to the last access time of files in the watched directory or subtree causes a change notification wait operation to return. |
Creation | 64 | Any change to the creation time of files in the watched directory or subtree causes a change notification wait operation to return. |
Security | 256 | Any security-descriptor change in the watched directory or subtree causes a change notification wait operation to return. |
Watch for changes in directory:
MBS("DirectoryWatcher.AddDirectory"; $Watcher; Directory Watcher::Directory; 1; "Filename¶DirName¶Attributes¶Size¶LastWrite¶LastAccess¶Creation¶Security")
Created 5th March 2017, last changed 26th May 2017
Dictionary.Values - DirectoryWatcher.ChangeCount
Feedback: Report problem or ask question.