FireVolumeEvents Property
The events that should be fired when a filesystem volume is mounted to or unmounted from the system.
Syntax
cbfilter.getFireVolumeEvents([callback]) cbfilter.setFireVolumeEvents( fireVolumeEvents, [callback])
Default Value
0
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for the getFireVolumeEvents([callback]) method is defined as:
function(err, data){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'data' is the value returned by the method.
The callback for the setFireVolumeEvents([callback]) method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
This property specifies the events that the class should fire when a filesystem volume is mounted to or unmounted from the system. Possible values are:
FS_MOUNT_IGNORE | 0 | Don't fire any events when volumes are mounted or unmounted. |
FS_MOUNT_NOTIFY | 64 | Fire Notification Events when volumes are mount or unmounted.
The NotifyFilterAttachToVolume and NotifyFilterDetachFromVolume events will fire, asynchronously, as necessary. |
FS_MOUNT_CONTROL | 128 | Fire Control Events when volumes are mounted or unmounted.
The BeforeFilterAttachToVolume, AfterFilterAttachToVolume, and AfterFilterDetachFromVolume events will fire, synchronously, as necessary. |
FS_MOUNT_BOTH | 192 | Fire all events when volumes are mounted or unmounted. |
Note that the aforementioned events are only fired for volumes mounted/unmounted after the StartFilter method is called. Typically, applications use these events to dynamically add or remove volume-specific filter rules that target removable volumes (like, e.g., USB drives), as well as create virtual files on such volumes. Please refer to the File Masks topic for more information.
Data Type
Integer