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:
9.3
9.4
9.5
10.0
10.1
10.2
10.3
10.4
10.5
10.6
Statistic
FMM
Blog
DirectoryWatcher.AddDirectory
Adds a directory to watch.
| Component | Version | macOS | Windows | Linux | Server | FileMaker iOS SDK |
| DirectoryWatcher | 7.1 | No | Yes | No | Yes, Windows only | 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.
| 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. |
Examples
Watch for changes in directory:
MBS("DirectoryWatcher.AddDirectory"; $Watcher; Directory Watcher::Directory; 1; "Filename¶DirName¶Attributes¶Size¶LastWrite¶LastAccess¶Creation¶Security")
Example Databases
Created 5th March 2017, last changed 26th May 2017
Dictionary.Values - DirectoryWatcher.ChangeCount
Feedback: Report problem or ask question.
Links
MBS Xojo Chart Plugins
