CBMonitor Component

Properties   Methods   Events   Config Settings   Errors  

The CBMonitor class allows applications to monitor filesystem requests.

Syntax

cbfsfilter.CBMonitor

Remarks

The CBMonitor struct is a "monitoring-only" subset of the CBFilter struct; it gives applications the ability to monitor filesystem requests, allowing them to be logged and reported. Applications use standard filter rules to specify which requests they are interested in monitoring.

To learn more about the struct's capabilities, please refer to the product's General Information topics.

Getting Started

  1. If the struct's system driver has not been installed yet, call the Install method to do so. This needs to be done only once.
    • In production, the driver can be installed (or updated) ahead of time by the application's installation script using the Installer DLL. Please refer to the Driver Installation topic for more information.
  2. Call the Initialize method to initialize the CBMonitor struct. This must be done each time the application starts.
  3. Add one or more filter rules using methods like AddFilterRule. (Rules can also be added/removed after the filter is started.)
  4. Call the StartFilter method to start monitoring filesystem requests.
  5. When finished, call the StopFilter method to stop monitoring filesystem requests.
  6. To uninstall the struct's system driver, call the Uninstall method. This should not be done as part of the driver upgrade process.
    • In production, the driver can be uninstalled by the application's uninstallation script using the Installer DLL. Please refer to the Driver Installation topic for more information.

Property List


The following is the full list of the properties of the component with short descriptions. Click on the links for further details.

ActiveThis property notes whether the class is active and processing requests.
AltitudeThis property specifies the altitude the class's system driver should use .
FilterRuleCountThe number of records in the FilterRule arrays.
FilterRuleAccessFlagsThis property indicates the access restrictions enforced by the rule (CBFilter only).
FilterRuleControlFlagsThis property indicates which control events the rule causes the class to fire (CBFilter only).
FilterRuleEaNameThis property indicates the name of an extended attribute that a file or directory must have to match the rule.
FilterRuleExcludedAttributesThis property indicates the file attributes that a file or directory must not have to match the rule.
FilterRuleIncludedAttributesThis property indicates the file attributes that a file or directory must have to match the rule.
FilterRuleMaskThis property indicates a file mask that determines which files and directories match the rule.
FilterRuleMaxSizeThis property indicates the maximum size a file can be to match the rule.
FilterRuleMinSizeThis property indicates the minimum size a file can be to match the rule.
FilterRuleNotifyFlagsThis property indicates which notification events the rule causes the class to fire.
FireVolumeEventsThis property specifies the events that should be fired when a filesystem volume is mounted to or unmounted from the system.
NormalizeShortFileNamesCBFILTER_NORMALIZE_SHORT_FILE_NAMES_NEVER 0 CBFILTER_NORMALIZE_SHORT_FILE_NAMES_LOCAL_FS 1 CBFILTER_NORMALIZE_SHORT_FILE_NAMES_ALWAYS 2, TBD.
PassthroughRuleCountThe number of records in the PassthroughRule arrays.
PassthroughRuleAccessFlagsThis property specifies the access restrictions lifted by the rule (CBFilter only).
PassthroughRuleControlFlagsThis property indicates which control events the rule prevents the class from firing (CBFilter only).
PassthroughRuleEaNameThis property indicates the name of an extended attribute that a file or directory must have to match the rule.
PassthroughRuleExcludedAttributesThis property indicates the file attributes that a file or directory must not have to match the rule.
PassthroughRuleIncludedAttributesThis property indicates the file attributes that a file or directory must have to match the rule.
PassthroughRuleMaskThis property indicates a file mask that determines which files and directories match the rule.
PassthroughRuleMaxSizeThis property indicates the maximum size a file can be to match the rule.
PassthroughRuleMinSizeThis property indicates the minimum size a file can be to match the rule.
PassthroughRuleNotifyFlagsThis property indicates which notification events the rule prevents the class from firing.
ProcessCachedIORequestsThis property specifies whether cached file read/write requests should be processed.
ProcessFailedRequestsThis property specifies whether failed requests should be processed.
SerializeEventsWhether events should be fired on a single worker thread, or many.
TagThis property stores application-defined data specific to a particular instance of the class.

Method List


The following is the full list of the methods of the component with short descriptions. Click on the links for further details.

AddFilterRuleThis method adds a standard filter rule.
AddFilterRuleExThis method adds a standard filter rule with additional match qualifiers.
AddPassthroughRuleThis method adds a passthrough rule.
AddPassthroughRuleExThis method adds a passthrough rule with additional match qualifiers.
ConfigSets or retrieves a configuration setting.
DeleteAllFilterRulesThis method deletes all standard filter rules.
DeleteAllPassthroughRulesThis method deletes all passthrough rules.
DeleteFilterRuleThis method deletes a particular standard filter rule.
DeletePassthroughRuleThis method deletes a particular passthrough rule.
FileMatchesMaskThis method checks whether a particular file or directory name matches the specified mask.
GetDOSPathNameThis method retrieves the DOS path name of the file or directory by its native (NT) path.
GetDriverStatusThis method retrieves the status of the class's system driver.
GetDriverVersionThis method retrieves the version of the class's system driver.
GetEventFileNameThis method retrieves the name of the file or directory, to which the event applies.
GetNTPathNameThis method retrieves the NT (native) path name of the file or directory by its DOS path.
GetOperationTimeThis method returns the time at which the request was received by the filter driver.
GetOriginatorProcessIdRetrieves the Id of the process (PID) that initiated the operation.
GetOriginatorProcessNameRetrieves the name of the process that initiated the operation.
GetOriginatorThreadIdRetrieves the Id of the thread that initiated the operation.
GetRemoteAccessInformationThis method returns networking-related information about the operation.
GetVolumeGUIDThis method retrieves the volume GUID of the device targeted by a filesystem operation.
InitializeThis method initializes the class.
InstallThis method installs (or upgrades) the class's system driver.
NtStatusToWin32ErrorThis method converts a native status code to a Win32 error code.
ShutdownSystemShuts down or reboots the operating system.
StartFilterThis method starts filtering filesystem operations.
StopFilterThis method stops filtering filesystem operations.
UninstallThis method uninstalls the class's system driver.

Event List


The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.

AfterFilterAttachToVolumeThis event fires after the filter attaches to a newly mounted filesystem volume.
AfterFilterDetachFromVolumeThis event fires after the filter detaches from a filesystem volume.
BeforeFilterAttachToVolumeThis event fires before the filter attaches to a newly mounted filesystem volume.
BypassIORequestThis event fires when the OS sends one of BypassIO commands.
ErrorThis event fires if an unhandled error occurs during an event.
FilterStartThis event fires once the filter has attached and filtering has started.
FilterStopThis event fires once filtering has stopped and the filter has detached.
NotifyCanFileBeDeletedThis event fires when the OS marks a file or directory for deletion or removes such a mark.
NotifyCleanupFileThis event fires when a file or directory handle has been closed.
NotifyCloseFileThis event fires when a file or directory has been closed.
NotifyCreateFileThis event fires when a file or directory has been created.
NotifyCreateHardLinkThis event fires when a hard link has been created.
NotifyDeleteFileThis event fires when a file or directory has been deleted.
NotifyDeleteReparsePointThis event fires when a file or directory's reparse point has been deleted.
NotifyEnumerateDirectoryThis event fires when a directory entry has been returned during directory enumeration.
NotifyFilterAttachToVolumeThis event fires when the filter has been attached to a newly mounted filesystem volume.
NotifyFilterDetachFromVolumeThis event fires when the filter has been detached from a filesystem volume.
NotifyFsctlThis event fires when an IRP_MJ_FILE_SYSTEM_CONTROL operation has occurred.
NotifyGetFileSecurityThis event fires when a file or directory's security attributes have been retrieved.
NotifyGetFileSizesThis event fires when a file's size information has been retrieved.
NotifyGetReparsePointThis event fires when a file or directory's reparse point information has been retrieved.
NotifyIoctlThis event fires when an IRP_MJ_DEVICE_CONTROL operation has occurred.
NotifyLockThis event fires when a range of bytes in a file has been locked.
NotifyOpenFileThis event fires when a file or directory has been opened.
NotifyQueryEaThis event fires when information about the extended attributes of a file has been retrieved.
NotifyQueryFileInfoThis event fires when information about a file or directory has been retrieved.
NotifyReadFileThis event fires when data have been read from a file.
NotifyRenameOrMoveFileThis event fires when a file or directory has been renamed or moved.
NotifySetAllocationSizeThis event fires when a file's allocation size has been changed.
NotifySetEaThis event fires when information about the extended attributes of a file has been changed.
NotifySetFileAttributesThis event fires when a file or directory's attributes or times have been changed.
NotifySetFileInfoThis event fires when information about a file or directory has been changed.
NotifySetFileSecurityThis event fires when a file or directory's security attributes have been changed.
NotifySetFileSizeThis event fires when a file has been resized.
NotifySetReparsePointThis event fires when a file or directory's reparse point has been created or updated.
NotifyUnlockAllThis event fires when all locked byte ranges in a file have been unlocked.
NotifyUnlockAllByKeyThis event fires when all locked byte ranges in a file, associated with a particular key, have been unlocked.
NotifyUnlockSingleThis event fires when a particular locked byte range in a file has been unlocked.
NotifyWriteFileThis event fires when data have been written to a file.
WorkerThreadCreationFires just after a new worker thread is created.
WorkerThreadTerminationFires just before a worker thread is terminated.

Config Settings


The following is a list of config settings for the component with short descriptions. Click on the links for further details.

AlwaysPrepareFilesWhether the driver should keep track of information for files that are already open when (i.e., were opened before) the class is initialized.
AlwaysRequestAttributesOnOpenWhether the driver should keep request existing attributes before file create/open operation.
CollectRemoteOpenInformationEnables collection of information about remote filesystem requests.
FilterOwnRequestsWhether the class's system driver should filter requests made by the application itself.
ForceAppPermissionCheckWhether the driver should require the controller process to have elevated or system privileges.
ForceSecurityChecksWhether the driver should prevent the controller process from filtering files that it would not normally have access to.
LoggingEnabledWhether extended logging is enabled.
MaxWorkerThreadCountThe maximum number of worker threads to use to fire events.
MinWorkerThreadCountThe minimum number of worker threads to use to fire events.
NormalizeShortFileNamesWhether the driver should attempt to resolve short file names and convert them to regular ones.
OmitEventFileNamesWhether the filename parameter should be empty in events.
PassAllFileNamesWhether the driver should pass all known names of a file, including hardlinks and previous names, to event handlers.
PassSecurityInFileOpenEventsWhether security information, associated with the file create/open request, is passed to file creation and opening events.
PreprocessedRulesCacheSizeMaximum number of preprocessed rules to keep cached.
RecordOperationTimeEnables collection of operation time.
ResolveNtDeviceToDriveLetterWhether native device names are translated to drive letters.
RetriveLinkNamesOnOpenSpecifies that the driver should collect all hard links when a file is opened.
SendRequestsViaDriverStackWhether internal requests to the filesystem are sent directly to the filesystem driver or through the stack of filesystem filter drivers.
WorkerInitialStackSizeThe initial stack size to create worker threads with.
BuildInfoInformation about the product's build.
LicenseInfoInformation about the current license.

Active Property (CBMonitor Component)

This property notes whether the class is active and processing requests.

Syntax

func (obj *CBMonitor) Active() (bool, error)

Default Value

false

Remarks

This property reflects whether the struct is active and currently processing requests. It will be true after the filter has been attached successfully via a call to StartFilter.

This property is read-only.

Data Type

bool

Altitude Property (CBMonitor Component)

This property specifies the altitude the class's system driver should use .

Syntax

func (obj *CBMonitor) Altitude() (string, error)
func (obj *CBMonitor) SetAltitude(value string) error

Default Value

""

Remarks

This property specifies the altitude that the struct's system driver should use . A driver's altitude determines its absolute position in the stack of filter drivers; drivers with higher altitudes are attached toward the top of the stack, closer to the user mode, which allows them to process requests earlier.

Microsoft manages and assigns filesystem minifilter driver altitudes directly, so an application-specific altitude value must be obtained from Microsoft before an application is deployed in production. Please refer to the Driver Altitudes topic for more information. During development, an appropriate arbitrary value, such as 360000 (which is not registered with Microsoft), can be used.

If this property is queried before an altitude has been set (via this property or the Install method), it will return an empty string.

Note: This property cannot be changed when Active is true. Additionally, the Initialize method must be called before attempting to get or set this property's value, which is stored in the registry.

Data Type

string

FilterRuleCount Property (CBMonitor Component)

The number of records in the FilterRule arrays.

Syntax

func (obj *CBMonitor) FilterRuleCount() (int32, error)

Default Value

0

Remarks

This property controls the size of the following arrays:

The array indices start at 0 and end at FilterRuleCount - 1.

This property is read-only.

Data Type

int32

FilterRuleAccessFlags Property (CBMonitor Component)

This property indicates the access restrictions enforced by the rule (CBFilter only).

Syntax

func (obj *CBMonitor) FilterRuleAccessFlags(FilterRuleIndex int32) (int32, error)

Default Value

0

Remarks

This property indicates the access restrictions enforced by the rule (CBFilter only).

This property indicates which access restrictions are enforced by the rule. Please refer to the Access Rules topic for more information. The value of this property is a combination of zero or more of the following:

ACCESS_NONE0x00No access restrictions.

ACCESS_READ_ONLY0x01Read-only access; writing and deleting are prohibited.

ACCESS_WRITE_ONLY0x02Write-only access; reading and deleting are prohibited.

ACCESS_DELETE_PROTECT0x04Deleting and renaming are prohibited.

ACCESS_EXECUTE_PROTECT0x08Execution is prohibited.

ACCESS_NO_CHANGE_DAC0x10Change of security attributes is prohibited.

ACCESS_NO_CHANGE_OWNER0x20Change of owner is prohibited.

ACCESS_RENAME_PROTECT0x40Renaming is prohibited.

ACCESS_DELETE_ONLY_PROTECT0x80Deleting is prohibited (renaming is not affected).

ACCESS_REMOTE_ACCESS_PROTECT0x100Access from other systems is prohibited.

ACCESS_DENY_ALL0x200All access is denied.

ACCESS_ALL_FLAGS-1Used to denote all currently set access restriction flags.

Note: This property is always 0 for the CBMonitor struct, which does not support access rules.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

int32

FilterRuleControlFlags Property (CBMonitor Component)

This property indicates which control events the rule causes the class to fire (CBFilter only).

Syntax

func (obj *CBMonitor) FilterRuleControlFlags(FilterRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates which control events the rule causes the struct to fire (CBFilter only).

This property indicates which filesystem operations, of those performed on matching files and directories, the struct should fire Control Events for. The value of this property is a combination of zero or more of the following:

FS_CE_NONE0Don't fire for any filesystem operations.

Control Events will not fire for any filesystem operations.

FS_CE_BEFORE_CREATE0x000000000001LFire before file creation operations.

The BeforeCreateFile event will fire anytime the OS attempts to create a file or directory. In some cases, this event can cause the BeforeOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_AFTER_CREATE0x000000000002LFire after file creation operations.

The AfterCreateFile event will fire after a file or directory creation request has been processed, before the response is returned. In some cases, this event can cause the AfterOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_BEFORE_OPEN0x000000000004LFire before file open operations.

The BeforeOpenFile event will fire anytime the OS attempts to open a file or directory. In some cases, this event can cause the BeforeCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_AFTER_OPEN0x000000000008LFire after file open operations.

The AfterOpenFile event will fire after a file or directory open request has been processed, before the response is returned. In some cases, this event can cause the AfterCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_BEFORE_READ0x000000000010LFire before read operations.

The BeforeReadFile event will fire anytime the OS attempts to read data from a file.

FS_CE_AFTER_READ0x000000000020LFire after read operations.

The AfterReadFile event will fire after a read request has been processed, before the response is returned.

FS_CE_BEFORE_WRITE0x000000000040LFire before write operations.

The BeforeWriteFile event will fire anytime the OS attempts to write data to a file.

FS_CE_AFTER_WRITE0x000000000080LFire after write operations.

The AfterReadFile event will fire after a write request has been processed, before the response is returned.

FS_CE_BEFORE_LOCK_CONTROL0x000000000100LFire before lock and unlock operations.

The BeforeLock, BeforeUnlockAll, BeforeUnlockAllByKey, and BeforeUnlockSingle events will fire, as applicable, before the OS attempts to lock or unlock a range of bytes in a file.

FS_CE_AFTER_LOCK_CONTROL0x000000000200LFire before and after lock and unlock operations.

The AfterLock, AfterUnlockAll, AfterUnlockAllByKey, and AfterUnlockSingle, events will fire, as applicable, after a lock or unlock request has been processed, before the response is returned.

FS_CE_BEFORE_CLEANUP0x000000000400LFire before file handle cleanup operations.

The BeforeCleanupFile event will fire anytime a process closes a file or directory handle.

FS_CE_AFTER_CLEANUP0x000000000800LFire after file handle cleanup operations.

The AfterCleanupFile event will fire after a file handle cleanup request has been processed, before the response is returned.

FS_CE_BEFORE_CLOSE0x000000001000LFire before file close operations.

The BeforeCloseFile event will fire anytime the OS closes a file or directory. Also, the AfterCloseEnumeration event will fire anytime the OS closes a directory enumeration (which typically occurs immediately before the directory is closed).

FS_CE_AFTER_CLOSE0x000000002000LFire after file close operations.

The AfterCloseFile event will fire after a file/directory close request has been processed, before the response is returned.

FS_CE_BEFORE_CAN_DELETE0x000000004000LFire before 'can be deleted' operations.

The BeforeCanFileBeDeleted event will fire anytime the OS checks whether a file or directory can be deleted.

FS_CE_AFTER_CAN_DELETE0x000000008000LFire after 'can be deleted' operations.

The AfterCanFileBeDeleted event will fire after a can be deleted request has been processed, before the response is returned.

FS_CE_BEFORE_DELETE0x000000010000LFire before delete operations

The BeforeDeleteFile event will fire anytime the OS attempts to delete a file or directory.

FS_CE_AFTER_DELETE0x000000020000LFire after delete operations.

The AfterDeleteFile event will fire after a delete request has been processed, before the response is returned.

FS_CE_BEFORE_RENAME0x000000040000LFire before rename/move operations.

The BeforeRenameOrMoveFile event will fire anytime the OS attempts to rename or move a file or directory.

FS_CE_AFTER_RENAME0x000000080000LFire after rename/move operations.

The AfterRenameOrMoveFile event will fire after a rename or move request has been processed, before the response is returned.

FS_CE_BEFORE_GET_SECURITY0x000000100000LFire before get security operations.

The BeforeGetFileSecurity event will fire before the OS queries the security attributes of a file or directory.

FS_CE_AFTER_GET_SECURITY0x000000200000LFire after get security operations.

The AfterGetFileSecurity events will fire after a get security operation has been processed, before the response is returned.

FS_CE_BEFORE_ENUMERATE_DIRECTORY0x000000400000LFire before directory enumeration operations.

The BeforeEnumerateDirectory event will fire anytime the OS needs to read information about directory entries.

FS_CE_AFTER_ENUMERATE_DIRECTORY0x000000800000LFire after directory enumeration operations.

The AfterEnumerateDirectory event will fire after information about a directory entry has been retrieved during directory enumeration, before the response is returned.

FS_CE_BEFORE_QUERY_FILE_INFO0x000001000000LFire before 'query file information' operations.

The BeforeQueryFileInfo event will fire anytime the OS needs to retrieve information about a file or directory.

FS_CE_AFTER_QUERY_FILE_INFO0x000002000000LFire after 'query file information' operations.

The AfterQueryFileInfo event will fire after a file or directory information query request has been processed, before the response is returned.

FS_CE_AFTER_GET_SIZES0x000008000000LFire after get size operations.

The AfterGetFileSizes event will fire after a file's size information is retrieved, before the response is returned.

FS_CE_BEFORE_SET_SECURITY0x000010000000LFire before set security operations.

The BeforeSetFileSecurity event will fire anytime the OS needs to change the security attributes of a file or directory.

FS_CE_AFTER_SET_SECURITY0x000020000000LFire after set security operations.

The AfterSetFileSecurity event will fire after a security attribute change request has been processed, before the response is returned.

FS_CE_BEFORE_SET_ATTRIBUTES0x000040000000LFire before file attribute update operations.

The BeforeSetFileAttributes event will fire anytime the OS attempts to change the attributes of a file or directory.

FS_CE_AFTER_SET_ATTRIBUTES0x000080000000LFire after file attribute update operations.

The AfterSetFileAttributes event will fire after a file attribute change request has been processed, before the response is returned.

FS_CE_BEFORE_SET_SIZES0x000100000000LFire before file resize operations.

The BeforeSetFileSize event will fire anytime the OS attempts to resize a file, and the BeforeSetAllocationSize event will fire anytime the OS attempts to change a file's allocation size.

FS_CE_AFTER_SET_SIZES0x000200000000LFire after file resize operations.

The AfterSetFileSize event will fire after a file resize request has been processed, and the AfterSetAllocationSize event will fire after a file allocation size change request has been processed, before the response is returned.

FS_CE_BEFORE_CREATE_HARD_LINK0x000400000000LFire before hard link creation operations.

The BeforeCreateHardLink event will fire anytime the OS attempts to create a hard link.

FS_CE_AFTER_CREATE_HARD_LINK0x000800000000LFire after hard link creation operations.

The AfterCreateHardLink events will fire after a hard link creation request has been processed, before the response is returned.

FS_CE_BEFORE_FSCTL0x001000000000LFire before FSCTL operations.

The BeforeFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL request occurs.

FS_CE_AFTER_FSCTL0x002000000000LFire after FSCTL operations.

The AfterFsctl event will fire after an IRP_MJ_FILE_SYSTEM_CONTROL request has been processed, before the response is returned.

FS_CE_BEFORE_IOCTL0x004000000000LFire before IOCTL operations.

The BeforeIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL request occurs.

FS_CE_AFTER_IOCTL0x008000000000LFire after IOCTL operations.

The AfterIoctl event will fire after an IRP_MJ_DEVICE_CONTROL request has been processed, before the response is returned.

FS_CE_BEFORE_SET_FILE_INFO0x010000000000LFire before 'set file information' operations.

The BeforeSetFileInfo event will fire anytime the OS needs to change information about a file or directory.

FS_CE_AFTER_SET_FILE_INFO0x020000000000LFire after 'set file information' operations.

The AfterSetFileInfo event will fire after a file or directory information change request has been processed, before the response is returned.

FS_CE_BEFORE_SET_EA0x040000000000LFire before Set Extended Attributes operations.

The BeforeSetEa event will fire anytime the OS needs to set extended attributes of a file.

FS_CE_AFTER_SET_EA0x080000000000LFire after Set Extended Attributes operations.

The AfterSetEa event will fire after the OS request to set extended attributes of a file has been processed, before the response is returned.

FS_CE_BEFORE_QUERY_EA0x100000000000LFire before Query Extended Attributes operations.

The BeforeQueryEa event will fire anytime the OS needs to retrieve extended attributes of a file.

FS_CE_AFTER_QUERY_EA0x200000000000LFire after Query Extended Attributes operations.

The AfterQueryEa event will fire after the OS request to retrieve extended attributes of a file has been processed, before the response is returned.

FS_CE_BEFORE_GET_REPARSE_POINT0x400000000000LFire before Get Reparse Point operations.

The BeforeGetReparsePoint event will fire anytime the OS needs to read a reparse point of a file or directory.

FS_CE_AFTER_GET_REPARSE_POINT0x800000000000LFire after Get Reparse Point operations.

The AfterGetReparsePoint event will fire after the OS request to read a reparse point of a file or directory has been processed, before the response is returned.

FS_CE_BEFORE_SET_REPARSE_POINT0x1000000000000LFire before Set Reparse Point operations.

The BeforeSetReparsePoint event will fire anytime the OS needs to set or update a reparse point for a file or directory.

FS_CE_AFTER_SET_REPARSE_POINT0x2000000000000LFire after Set Reparse Point operations.

The AfterSetReparsePoint event will fire after the OS request to set or update a reparse point for a file or directory has been processed, before the response is returned.

FS_CE_BEFORE_DELETE_REPARSE_POINT0x4000000000000LFire before Delete Reparse Point operations.

The BeforeDeleteReparsePoint event will fire anytime the OS needs to remove reparse point information from a file or directory.

FS_CE_AFTER_DELETE_REPARSE_POINT0x8000000000000LFire after Delete Reparse Point operations.

The AfterDeleteReparsePoint event will fire after the OS request to remove reparse point information from a file or directory has been processed, before the response is returned.

FS_CE_REPARSE_FILENAME0x40000000000000LFire before various operations for the purpose of file redirection.

The ReparseFileName event will fire before any operation that includes a file or directory name, giving the application a chance to redirect it. This event is typically used when an application requires more advanced redirection logic than Reparse Rules can provide; please refer to that topic for more information.

FS_CE_REPARSE_TAG0x80000000000000LFire for reparse operations.

The ReparseWithTag event will fire anytime a file/directory open operation returns a STATUS_REPARSE result, allowing the application to handle the reparse point. Please refer to Microsoft's Reparse Points article for more information.

FS_CE_ALL-1Fire for all filesystem operations.

Control Events will fire for all filesystem operations that the struct tracks.

Note: This property is always 0 for the CBMonitor struct, which does not provide any Control Events for filesystem operations.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

int64

FilterRuleEaName Property (CBMonitor Component)

This property indicates the name of an extended attribute that a file or directory must have to match the rule.

Syntax

func (obj *CBMonitor) FilterRuleEaName(FilterRuleIndex int32) (string, error)

Default Value

""

Remarks

This property indicates the name of an extended attribute that a file or directory must have to match the rule.

This property reflects the name of an extended attribute that a file or directory must have to qualify as a match for the rule. A value of an empty string indicates that the rule does not use this property as a match qualifier.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

string

FilterRuleExcludedAttributes Property (CBMonitor Component)

This property indicates the file attributes that a file or directory must not have to match the rule.

Syntax

func (obj *CBMonitor) FilterRuleExcludedAttributes(FilterRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the file attributes that a file or directory must not have to match the rule.

This property indicates which file attributes a file or directory must not have to qualify as a match for the rule. A value of 0 indicates that the rule does not use this property as a match qualifier.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

int64

FilterRuleIncludedAttributes Property (CBMonitor Component)

This property indicates the file attributes that a file or directory must have to match the rule.

Syntax

func (obj *CBMonitor) FilterRuleIncludedAttributes(FilterRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the file attributes that a file or directory must have to match the rule.

This property indicates which file attributes a file or directory must have to qualify as a match for the rule. A value of 0 indicates that the rule does not use this property as a match qualifier.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

int64

FilterRuleMask Property (CBMonitor Component)

This property indicates a file mask that determines which files and directories match the rule.

Syntax

func (obj *CBMonitor) FilterRuleMask(FilterRuleIndex int32) (string, error)

Default Value

""

Remarks

This property indicates a file mask that determines which files and directories match the rule.

This property reflects the file mask used to determine whether a file or directory matches the rule. In addition to being its primary match qualifier, a rule's mask also serves as its identifier; every rule in a ruleset must have a unique mask.

Note: When a rule with a drive letter is added, said drive letter is automatically converted to NT Device format. When the ResolveNtDeviceToDriveLetter configuration setting is disabled, this property's value will contain the NT Device name. When the ResolveNtDeviceToDriveLetter configuration setting is enabled, the struct attempts to convert the mask back to the DOS format with a drive letter. In some situations, such backward conversion can lead to a path that was different from the original path added.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

string

FilterRuleMaxSize Property (CBMonitor Component)

This property indicates the maximum size a file can be to match the rule.

Syntax

func (obj *CBMonitor) FilterRuleMaxSize(FilterRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the maximum size a file can be to match the rule.

This property indicates the maximum size, in bytes, that a file can be to qualify as a match for the rule. A value of -1 indicates that the rule does not use this property as a match qualifier.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

int64

FilterRuleMinSize Property (CBMonitor Component)

This property indicates the minimum size a file can be to match the rule.

Syntax

func (obj *CBMonitor) FilterRuleMinSize(FilterRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the minimum size a file can be to match the rule.

This property indicates the minimum size, in bytes, that a file can be to qualify as a match for the rule. A value of -1 indicates that the rule does not use this property as a match qualifier.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

int64

FilterRuleNotifyFlags Property (CBMonitor Component)

This property indicates which notification events the rule causes the class to fire.

Syntax

func (obj *CBMonitor) FilterRuleNotifyFlags(FilterRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates which notification events the rule causes the struct to fire.

This property indicates which filesystem operations, of those performed on matching files and directories, the struct should fire Notification Events for. The value of this property is a combination of zero or more of the following:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

The FilterRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the FilterRuleCount property.

This property is read-only.

Data Type

int64

FireVolumeEvents Property (CBMonitor Component)

This property specifies the events that should be fired when a filesystem volume is mounted to or unmounted from the system.

Syntax

func (obj *CBMonitor) FireVolumeEvents() (int32, error)
func (obj *CBMonitor) SetFireVolumeEvents(value int32) error

Default Value

0

Remarks

This property specifies the events that the struct should fire when a filesystem volume is mounted to or unmounted from the system. Possible values are as follows:

FS_MOUNT_IGNORE0Don't fire any events when volumes are mounted or unmounted.

FS_MOUNT_NOTIFY64Fire Notification Events when volumes are mounted or unmounted.

The NotifyFilterAttachToVolume and NotifyFilterDetachFromVolume events will fire, asynchronously, as necessary.

FS_MOUNT_CONTROL128Fire Control Events when volumes are mounted or unmounted.

The BeforeFilterAttachToVolume, AfterFilterAttachToVolume, and AfterFilterDetachFromVolume events will fire, synchronously, as necessary.

FS_MOUNT_BOTH192Fire all events when volumes are mounted or unmounted.

Note: The aforementioned events are fired only 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 (e.g., USB drives) as well as to create virtual files on such volumes. Please refer to the File Masks topic for more information.

Data Type

int32

NormalizeShortFileNames Property (CBMonitor Component)

CBFILTER_NORMALIZE_SHORT_FILE_NAMES_NEVER 0 CBFILTER_NORMALIZE_SHORT_FILE_NAMES_LOCAL_FS 1 CBFILTER_NORMALIZE_SHORT_FILE_NAMES_ALWAYS 2, TBD.

Syntax

func (obj *CBMonitor) NormalizeShortFileNames() (int32, error)
func (obj *CBMonitor) SetNormalizeShortFileNames(value int32) error

Default Value

0

Remarks

TBD.

Data Type

int32

PassthroughRuleCount Property (CBMonitor Component)

The number of records in the PassthroughRule arrays.

Syntax

func (obj *CBMonitor) PassthroughRuleCount() (int32, error)

Default Value

0

Remarks

This property controls the size of the following arrays:

The array indices start at 0 and end at PassthroughRuleCount - 1.

This property is read-only.

Data Type

int32

PassthroughRuleAccessFlags Property (CBMonitor Component)

This property specifies the access restrictions lifted by the rule (CBFilter only).

Syntax

func (obj *CBMonitor) PassthroughRuleAccessFlags(PassthroughRuleIndex int32) (int32, error)

Default Value

0

Remarks

This property specifies the access restrictions lifted by the rule (CBFilter only).

This property indicates which access restrictions are lifted by the rule. Please refer to the Passthrough Rules topic for more information. The value of this property is a combination of zero or more of the following:

ACCESS_NONE0x00No access restrictions.

ACCESS_READ_ONLY0x01Read-only access; writing and deleting are prohibited.

ACCESS_WRITE_ONLY0x02Write-only access; reading and deleting are prohibited.

ACCESS_DELETE_PROTECT0x04Deleting and renaming are prohibited.

ACCESS_EXECUTE_PROTECT0x08Execution is prohibited.

ACCESS_NO_CHANGE_DAC0x10Change of security attributes is prohibited.

ACCESS_NO_CHANGE_OWNER0x20Change of owner is prohibited.

ACCESS_RENAME_PROTECT0x40Renaming is prohibited.

ACCESS_DELETE_ONLY_PROTECT0x80Deleting is prohibited (renaming is not affected).

ACCESS_REMOTE_ACCESS_PROTECT0x100Access from other systems is prohibited.

ACCESS_DENY_ALL0x200All access is denied.

ACCESS_ALL_FLAGS-1Used to denote all currently set access restriction flags.

Note: This property is always 0 for the CBMonitor struct, which does not support access rules.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

int32

PassthroughRuleControlFlags Property (CBMonitor Component)

This property indicates which control events the rule prevents the class from firing (CBFilter only).

Syntax

func (obj *CBMonitor) PassthroughRuleControlFlags(PassthroughRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates which control events the rule prevents the struct from firing (CBFilter only).

This property indicates which filesystem operations, of those performed on matching files and directories, the struct should not fire Control Events for. Please refer to the Passthrough Rules topic for more information. The value of this property is a combination of zero or more of the following:

FS_CE_NONE0Don't fire for any filesystem operations.

Control Events will not fire for any filesystem operations.

FS_CE_BEFORE_CREATE0x000000000001LFire before file creation operations.

The BeforeCreateFile event will fire anytime the OS attempts to create a file or directory. In some cases, this event can cause the BeforeOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_AFTER_CREATE0x000000000002LFire after file creation operations.

The AfterCreateFile event will fire after a file or directory creation request has been processed, before the response is returned. In some cases, this event can cause the AfterOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_BEFORE_OPEN0x000000000004LFire before file open operations.

The BeforeOpenFile event will fire anytime the OS attempts to open a file or directory. In some cases, this event can cause the BeforeCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_AFTER_OPEN0x000000000008LFire after file open operations.

The AfterOpenFile event will fire after a file or directory open request has been processed, before the response is returned. In some cases, this event can cause the AfterCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_CE_BEFORE_READ0x000000000010LFire before read operations.

The BeforeReadFile event will fire anytime the OS attempts to read data from a file.

FS_CE_AFTER_READ0x000000000020LFire after read operations.

The AfterReadFile event will fire after a read request has been processed, before the response is returned.

FS_CE_BEFORE_WRITE0x000000000040LFire before write operations.

The BeforeWriteFile event will fire anytime the OS attempts to write data to a file.

FS_CE_AFTER_WRITE0x000000000080LFire after write operations.

The AfterReadFile event will fire after a write request has been processed, before the response is returned.

FS_CE_BEFORE_LOCK_CONTROL0x000000000100LFire before lock and unlock operations.

The BeforeLock, BeforeUnlockAll, BeforeUnlockAllByKey, and BeforeUnlockSingle events will fire, as applicable, before the OS attempts to lock or unlock a range of bytes in a file.

FS_CE_AFTER_LOCK_CONTROL0x000000000200LFire before and after lock and unlock operations.

The AfterLock, AfterUnlockAll, AfterUnlockAllByKey, and AfterUnlockSingle, events will fire, as applicable, after a lock or unlock request has been processed, before the response is returned.

FS_CE_BEFORE_CLEANUP0x000000000400LFire before file handle cleanup operations.

The BeforeCleanupFile event will fire anytime a process closes a file or directory handle.

FS_CE_AFTER_CLEANUP0x000000000800LFire after file handle cleanup operations.

The AfterCleanupFile event will fire after a file handle cleanup request has been processed, before the response is returned.

FS_CE_BEFORE_CLOSE0x000000001000LFire before file close operations.

The BeforeCloseFile event will fire anytime the OS closes a file or directory. Also, the AfterCloseEnumeration event will fire anytime the OS closes a directory enumeration (which typically occurs immediately before the directory is closed).

FS_CE_AFTER_CLOSE0x000000002000LFire after file close operations.

The AfterCloseFile event will fire after a file/directory close request has been processed, before the response is returned.

FS_CE_BEFORE_CAN_DELETE0x000000004000LFire before 'can be deleted' operations.

The BeforeCanFileBeDeleted event will fire anytime the OS checks whether a file or directory can be deleted.

FS_CE_AFTER_CAN_DELETE0x000000008000LFire after 'can be deleted' operations.

The AfterCanFileBeDeleted event will fire after a can be deleted request has been processed, before the response is returned.

FS_CE_BEFORE_DELETE0x000000010000LFire before delete operations

The BeforeDeleteFile event will fire anytime the OS attempts to delete a file or directory.

FS_CE_AFTER_DELETE0x000000020000LFire after delete operations.

The AfterDeleteFile event will fire after a delete request has been processed, before the response is returned.

FS_CE_BEFORE_RENAME0x000000040000LFire before rename/move operations.

The BeforeRenameOrMoveFile event will fire anytime the OS attempts to rename or move a file or directory.

FS_CE_AFTER_RENAME0x000000080000LFire after rename/move operations.

The AfterRenameOrMoveFile event will fire after a rename or move request has been processed, before the response is returned.

FS_CE_BEFORE_GET_SECURITY0x000000100000LFire before get security operations.

The BeforeGetFileSecurity event will fire before the OS queries the security attributes of a file or directory.

FS_CE_AFTER_GET_SECURITY0x000000200000LFire after get security operations.

The AfterGetFileSecurity events will fire after a get security operation has been processed, before the response is returned.

FS_CE_BEFORE_ENUMERATE_DIRECTORY0x000000400000LFire before directory enumeration operations.

The BeforeEnumerateDirectory event will fire anytime the OS needs to read information about directory entries.

FS_CE_AFTER_ENUMERATE_DIRECTORY0x000000800000LFire after directory enumeration operations.

The AfterEnumerateDirectory event will fire after information about a directory entry has been retrieved during directory enumeration, before the response is returned.

FS_CE_BEFORE_QUERY_FILE_INFO0x000001000000LFire before 'query file information' operations.

The BeforeQueryFileInfo event will fire anytime the OS needs to retrieve information about a file or directory.

FS_CE_AFTER_QUERY_FILE_INFO0x000002000000LFire after 'query file information' operations.

The AfterQueryFileInfo event will fire after a file or directory information query request has been processed, before the response is returned.

FS_CE_AFTER_GET_SIZES0x000008000000LFire after get size operations.

The AfterGetFileSizes event will fire after a file's size information is retrieved, before the response is returned.

FS_CE_BEFORE_SET_SECURITY0x000010000000LFire before set security operations.

The BeforeSetFileSecurity event will fire anytime the OS needs to change the security attributes of a file or directory.

FS_CE_AFTER_SET_SECURITY0x000020000000LFire after set security operations.

The AfterSetFileSecurity event will fire after a security attribute change request has been processed, before the response is returned.

FS_CE_BEFORE_SET_ATTRIBUTES0x000040000000LFire before file attribute update operations.

The BeforeSetFileAttributes event will fire anytime the OS attempts to change the attributes of a file or directory.

FS_CE_AFTER_SET_ATTRIBUTES0x000080000000LFire after file attribute update operations.

The AfterSetFileAttributes event will fire after a file attribute change request has been processed, before the response is returned.

FS_CE_BEFORE_SET_SIZES0x000100000000LFire before file resize operations.

The BeforeSetFileSize event will fire anytime the OS attempts to resize a file, and the BeforeSetAllocationSize event will fire anytime the OS attempts to change a file's allocation size.

FS_CE_AFTER_SET_SIZES0x000200000000LFire after file resize operations.

The AfterSetFileSize event will fire after a file resize request has been processed, and the AfterSetAllocationSize event will fire after a file allocation size change request has been processed, before the response is returned.

FS_CE_BEFORE_CREATE_HARD_LINK0x000400000000LFire before hard link creation operations.

The BeforeCreateHardLink event will fire anytime the OS attempts to create a hard link.

FS_CE_AFTER_CREATE_HARD_LINK0x000800000000LFire after hard link creation operations.

The AfterCreateHardLink events will fire after a hard link creation request has been processed, before the response is returned.

FS_CE_BEFORE_FSCTL0x001000000000LFire before FSCTL operations.

The BeforeFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL request occurs.

FS_CE_AFTER_FSCTL0x002000000000LFire after FSCTL operations.

The AfterFsctl event will fire after an IRP_MJ_FILE_SYSTEM_CONTROL request has been processed, before the response is returned.

FS_CE_BEFORE_IOCTL0x004000000000LFire before IOCTL operations.

The BeforeIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL request occurs.

FS_CE_AFTER_IOCTL0x008000000000LFire after IOCTL operations.

The AfterIoctl event will fire after an IRP_MJ_DEVICE_CONTROL request has been processed, before the response is returned.

FS_CE_BEFORE_SET_FILE_INFO0x010000000000LFire before 'set file information' operations.

The BeforeSetFileInfo event will fire anytime the OS needs to change information about a file or directory.

FS_CE_AFTER_SET_FILE_INFO0x020000000000LFire after 'set file information' operations.

The AfterSetFileInfo event will fire after a file or directory information change request has been processed, before the response is returned.

FS_CE_BEFORE_SET_EA0x040000000000LFire before Set Extended Attributes operations.

The BeforeSetEa event will fire anytime the OS needs to set extended attributes of a file.

FS_CE_AFTER_SET_EA0x080000000000LFire after Set Extended Attributes operations.

The AfterSetEa event will fire after the OS request to set extended attributes of a file has been processed, before the response is returned.

FS_CE_BEFORE_QUERY_EA0x100000000000LFire before Query Extended Attributes operations.

The BeforeQueryEa event will fire anytime the OS needs to retrieve extended attributes of a file.

FS_CE_AFTER_QUERY_EA0x200000000000LFire after Query Extended Attributes operations.

The AfterQueryEa event will fire after the OS request to retrieve extended attributes of a file has been processed, before the response is returned.

FS_CE_BEFORE_GET_REPARSE_POINT0x400000000000LFire before Get Reparse Point operations.

The BeforeGetReparsePoint event will fire anytime the OS needs to read a reparse point of a file or directory.

FS_CE_AFTER_GET_REPARSE_POINT0x800000000000LFire after Get Reparse Point operations.

The AfterGetReparsePoint event will fire after the OS request to read a reparse point of a file or directory has been processed, before the response is returned.

FS_CE_BEFORE_SET_REPARSE_POINT0x1000000000000LFire before Set Reparse Point operations.

The BeforeSetReparsePoint event will fire anytime the OS needs to set or update a reparse point for a file or directory.

FS_CE_AFTER_SET_REPARSE_POINT0x2000000000000LFire after Set Reparse Point operations.

The AfterSetReparsePoint event will fire after the OS request to set or update a reparse point for a file or directory has been processed, before the response is returned.

FS_CE_BEFORE_DELETE_REPARSE_POINT0x4000000000000LFire before Delete Reparse Point operations.

The BeforeDeleteReparsePoint event will fire anytime the OS needs to remove reparse point information from a file or directory.

FS_CE_AFTER_DELETE_REPARSE_POINT0x8000000000000LFire after Delete Reparse Point operations.

The AfterDeleteReparsePoint event will fire after the OS request to remove reparse point information from a file or directory has been processed, before the response is returned.

FS_CE_REPARSE_FILENAME0x40000000000000LFire before various operations for the purpose of file redirection.

The ReparseFileName event will fire before any operation that includes a file or directory name, giving the application a chance to redirect it. This event is typically used when an application requires more advanced redirection logic than Reparse Rules can provide; please refer to that topic for more information.

FS_CE_REPARSE_TAG0x80000000000000LFire for reparse operations.

The ReparseWithTag event will fire anytime a file/directory open operation returns a STATUS_REPARSE result, allowing the application to handle the reparse point. Please refer to Microsoft's Reparse Points article for more information.

FS_CE_ALL-1Fire for all filesystem operations.

Control Events will fire for all filesystem operations that the struct tracks.

Note: This property is always 0 for the CBMonitor struct, which does not provide any Control Events for filesystem operations.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

int64

PassthroughRuleEaName Property (CBMonitor Component)

This property indicates the name of an extended attribute that a file or directory must have to match the rule.

Syntax

func (obj *CBMonitor) PassthroughRuleEaName(PassthroughRuleIndex int32) (string, error)

Default Value

""

Remarks

This property indicates the name of an extended attribute that a file or directory must have to match the rule.

This property reflects the name of an extended attribute that a file or directory must have to qualify as a match for the rule. A value of an empty string indicates that the rule does not use this property as a match qualifier.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

string

PassthroughRuleExcludedAttributes Property (CBMonitor Component)

This property indicates the file attributes that a file or directory must not have to match the rule.

Syntax

func (obj *CBMonitor) PassthroughRuleExcludedAttributes(PassthroughRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the file attributes that a file or directory must not have to match the rule.

This property indicates which file attributes a file or directory must not have to qualify as a match for the rule. A value of 0 indicates that the rule does not use this property as a match qualifier.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

int64

PassthroughRuleIncludedAttributes Property (CBMonitor Component)

This property indicates the file attributes that a file or directory must have to match the rule.

Syntax

func (obj *CBMonitor) PassthroughRuleIncludedAttributes(PassthroughRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the file attributes that a file or directory must have to match the rule.

This property indicates which file attributes a file or directory must have to qualify as a match for the rule. A value of 0 indicates that the rule does not use this property as a match qualifier.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

int64

PassthroughRuleMask Property (CBMonitor Component)

This property indicates a file mask that determines which files and directories match the rule.

Syntax

func (obj *CBMonitor) PassthroughRuleMask(PassthroughRuleIndex int32) (string, error)

Default Value

""

Remarks

This property indicates a file mask that determines which files and directories match the rule.

This property reflects the file mask used to determine whether a file or directory matches the rule. In addition to being its primary match qualifier, a rule's mask also serves as its identifier; every rule in a ruleset must have a unique mask.

Note: When a rule with a drive letter is added, said drive letter is automatically converted to NT Device format. When the ResolveNtDeviceToDriveLetter configuration setting is disabled, this property's value will contain the NT Device name. When the ResolveNtDeviceToDriveLetter configuration setting is enabled, the struct attempts to convert the mask back to the DOS format with a drive letter. In some situations, such backward conversion can lead to a path that was different from the original path added.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

string

PassthroughRuleMaxSize Property (CBMonitor Component)

This property indicates the maximum size a file can be to match the rule.

Syntax

func (obj *CBMonitor) PassthroughRuleMaxSize(PassthroughRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the maximum size a file can be to match the rule.

This property indicates the maximum size, in bytes, that a file can be to qualify as a match for the rule. A value of -1 indicates that the rule does not use this property as a match qualifier.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

int64

PassthroughRuleMinSize Property (CBMonitor Component)

This property indicates the minimum size a file can be to match the rule.

Syntax

func (obj *CBMonitor) PassthroughRuleMinSize(PassthroughRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates the minimum size a file can be to match the rule.

This property indicates the minimum size, in bytes, that a file can be to qualify as a match for the rule. A value of -1 indicates that the rule does not use this property as a match qualifier.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

int64

PassthroughRuleNotifyFlags Property (CBMonitor Component)

This property indicates which notification events the rule prevents the class from firing.

Syntax

func (obj *CBMonitor) PassthroughRuleNotifyFlags(PassthroughRuleIndex int32) (int64, error)

Default Value

0

Remarks

This property indicates which notification events the rule prevents the struct from firing.

This property indicates which filesystem operations, of those performed on matching files and directories, the struct should not fire Notification Events for. Please refer to the Passthrough Rules topic for more information. The value of this property is a combination of zero or more of the following:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

The PassthroughRuleIndex parameter specifies the index of the item in the array. The size of the array is controlled by the PassthroughRuleCount property.

This property is read-only.

Data Type

int64

ProcessCachedIORequests Property (CBMonitor Component)

This property specifies whether cached file read/write requests should be processed.

Syntax

func (obj *CBMonitor) ProcessCachedIORequests() (bool, error)
func (obj *CBMonitor) SetProcessCachedIORequests(value bool) error

Default Value

false

Remarks

This property specifies whether the struct's system driver should process cached file read/write requests (i.e., fire *ReadFile and *WriteFile events for them). Please refer to the Cached and Non-Cached Requests topic for more information.

Note: This property cannot be changed when Active is true.

Data Type

bool

ProcessFailedRequests Property (CBMonitor Component)

This property specifies whether failed requests should be processed.

Syntax

func (obj *CBMonitor) ProcessFailedRequests() (bool, error)
func (obj *CBMonitor) SetProcessFailedRequests(value bool) error

Default Value

false

Remarks

This property specifies whether the struct's system driver should process failed requests (i.e., fire After* or Notify* events for them).

When this property is enabled, applications can inspect the Status parameter of the aforementioned events to determine whether an operation has failed. If an operation fails, then the corresponding event's Status parameter will contain a nonzero native status code. Applications generally can use the NtStatusToWin32Error method to convert these status codes into Win32 error codes (but keep in mind that not all native status codes have direct Win32 error code mapping).

Data Type

bool

SerializeEvents Property (CBMonitor Component)

Whether events should be fired on a single worker thread, or many.

Syntax

func (obj *CBMonitor) SerializeEvents() (int32, error)
func (obj *CBMonitor) SetSerializeEvents(value int32) error

Default Value

0

Remarks

This property specifies whether the struct should fire all events serially on a single worker thread, or concurrently on multiple worker threads. The possible values are:

0 (seOnMultipleThreads) The struct fires events in the context of multiple worker threads. The MinWorkerThreadCount and MaxWorkerThreadCount configuration settings control how many worker threads are used for this.
1 (seOnOneWorkerThread) The struct fires events in the context of one background worker thread.

Please refer to the Threading and Concurrency topic for more information.

Note: This property cannot be changed when Active is true, and it cannot be changed within events.

Data Type

int32

Tag Property (CBMonitor Component)

This property stores application-defined data specific to a particular instance of the class.

Syntax

func (obj *CBMonitor) Tag() (int64, error)
func (obj *CBMonitor) SetTag(value int64) error

Default Value

0

Remarks

This property can be used to store data specific to a particular instance of the struct.

Data Type

int64

AddFilterRule Method (CBMonitor Component)

This method adds a standard filter rule.

Syntax

func (obj *CBMonitor) AddFilterRule(Mask string, NotifyFlags int64) (bool, error)

Remarks

This method adds a standard filter rule for the files and directories that match the specified Mask. Each rule in a ruleset is uniquely identified by its mask; if a rule with the specified mask already exists, the new rule's parameters are merged into it.

If the rule is added successfully, this method returns true; otherwise, it returns false.

Standard filter rules determine which filesystem operations, of those performed on matching files and directories, the struct should fire its events for.

The Mask parameter must be a valid file mask according to the File Masks topic. Only the files and directories that match the specified mask will be covered by the rule.

The NotifyFlags parameter specifies which filesystem operations the struct should fire Notification Events for. For example, if the FS_NE_READ flag is present, the NotifyReadFile event will fire after a read operation is performed on any file that matches Mask. The value passed for this parameter should be constructed by ORing together zero or more of the following flags:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

AddFilterRuleEx Method (CBMonitor Component)

This method adds a standard filter rule with additional match qualifiers.

Syntax

func (obj *CBMonitor) AddFilterRuleEx(Mask string, EaName string, NotifyFlags int64, MinSize int64, MaxSize int64, IncludedAttributes int64, ExcludedAttributes int64) (bool, error)

Remarks

This method adds a standard filter rule for the files and directories that match the specified Mask (which must be provided) and other qualifiers (which are optional). Each rule in a ruleset is uniquely identified by its mask; if a rule with the specified mask already exists, the new rule's parameters are merged into it.

If the rule is added successfully, this method returns true; otherwise, it returns false.

Standard filter rules determine which filesystem operations, of those performed on matching files and directories, the struct should fire its events for.

The Mask parameter must be a valid file mask according to the File Masks topic. Only the files and directories that match the specified mask will be covered by the rule.

The EaName parameter specifies the name of an extended attribute that a file or directory must have to qualify as a match; wildcards are not allowed. Pass an empty string if this parameter should not be used as a match qualifier.

The NotifyFlags parameter specifies which filesystem operations the struct should fire Notification Events for. For example, if the FS_NE_READ flag is present, the NotifyReadFile event will fire after a read operation is performed on any file that matches Mask. The value passed for this parameter should be constructed by ORing together zero or more of the following flags:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

The MinSize and MaxSize parameters specify the minimum and maximum size, in bytes, that a file can be to qualify as a match. Pass -1 for either parameter if it should not be used as a match qualifier.

The IncludedAttributes and ExcludedAttributes parameters specify which file attributes a file or directory must have or not have to qualify as a match. Pass 0 for either parameter if it should not be used as a match qualifier.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

AddPassthroughRule Method (CBMonitor Component)

This method adds a passthrough rule.

Syntax

func (obj *CBMonitor) AddPassthroughRule(Mask string, NotifyFlags int64) (bool, error)

Remarks

This method adds a passthrough rule for the files and directories that match the specified Mask. Each rule in a ruleset is uniquely identified by its mask; if a rule with the specified mask already exists, the new rule's parameters are merged into it.

If the rule is added successfully, this method returns true; otherwise, it returns false.

Passthrough rules exclude matching files and directories from being processed by other filter rules.

The Mask parameter must be a valid file mask according to the File Masks topic. Only the files and directories that match the specified mask will be covered by the rule.

The NotifyFlags parameter specifies which filesystem operations the struct should not fire Notification Events for. The value passed for this parameter should be constructed by ORing together zero or more of the following flags:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

AddPassthroughRuleEx Method (CBMonitor Component)

This method adds a passthrough rule with additional match qualifiers.

Syntax

func (obj *CBMonitor) AddPassthroughRuleEx(Mask string, EaName string, NotifyFlags int64, MinSize int64, MaxSize int64, IncludedAttributes int64, ExcludedAttributes int64) (bool, error)

Remarks

This method adds a passthrough rule for the files and directories that match the specified Mask (which must be provided) and other qualifiers (which are optional). Each rule in a ruleset is uniquely identified by its mask; if a rule with the specified mask already exists, the new rule's parameters are merged into it.

If the rule is added successfully, this method returns true; otherwise, it returns false.

Passthrough rules exclude matching files and directories from being processed by other filter rules.

The Mask parameter must be a valid file mask according to the File Masks topic. Only the files and directories that match the specified mask will be covered by the rule.

The EaName parameter specifies the name of an extended attribute that a file or directory must have to qualify as a match; wildcards are not allowed. Pass an empty string if this parameter should not be used as a match qualifier.

The NotifyFlags parameter specifies which filesystem operations the struct should not fire Notification Events for. The value passed for this parameter should be constructed by ORing together zero or more of the following flags:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

The MinSize and MaxSize parameters specify the minimum and maximum size, in bytes, that a file can be to qualify as a match. Pass -1 for either parameter if it should not be used as a match qualifier.

The IncludedAttributes and ExcludedAttributes parameters specify which file attributes a file or directory must have or not have to qualify as a match. Pass 0 for either parameter if it should not be used as a match qualifier.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

Config Method (CBMonitor Component)

Sets or retrieves a configuration setting.

Syntax

func (obj *CBMonitor) Config(ConfigurationString string) (string, error)

Remarks

Config is a generic method available in every struct. It is used to set and retrieve configuration settings for the struct.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the struct, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

DeleteAllFilterRules Method (CBMonitor Component)

This method deletes all standard filter rules.

Syntax

func (obj *CBMonitor) DeleteAllFilterRules() (bool, error)

Remarks

This method deletes all standard filter rules that are currently present.

If the rules are deleted successfully, this method returns true; otherwise, it returns false.

To delete standard filter rules individually, use the DeleteFilterRule method instead.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

DeleteAllPassthroughRules Method (CBMonitor Component)

This method deletes all passthrough rules.

Syntax

func (obj *CBMonitor) DeleteAllPassthroughRules() (bool, error)

Remarks

This method deletes all passthrough rules that are currently present.

If the rules are deleted successfully, this method returns true; otherwise, it returns false.

To delete passthrough rules individually, use the DeletePassthroughRule method instead.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

DeleteFilterRule Method (CBMonitor Component)

This method deletes a particular standard filter rule.

Syntax

func (obj *CBMonitor) DeleteFilterRule(Mask string, NotifyFlags int64) (bool, error)

Remarks

This method deletes the specified NotifyFlags from the standard filter rule identified by Mask. If NotifyFlags includes all flags currently present in the rule, then the entire rule is deleted; otherwise, the flags specified by NotifyFlags are simply removed from the rule. If the flags or this rule are deleted successfully, this method returns true; otherwise, it returns false.

The Mask parameter must be the file mask of an existing rule. If a rule with the specified mask cannot be found, this method will fail.

The NotifyFlags parameter specifies which Notification Event flags should be removed from the rule. The value passed for this parameter should be constructed by ORing together zero or more of the following flags:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

To delete all standard filter rules, use the DeleteAllFilterRules method instead.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

DeletePassthroughRule Method (CBMonitor Component)

This method deletes a particular passthrough rule.

Syntax

func (obj *CBMonitor) DeletePassthroughRule(Mask string, NotifyFlags int64) (bool, error)

Remarks

This method deletes the specified NotifyFlags from the passthrough rule identified by Mask. If NotifyFlags includes all flags currently present in the rule, then the entire rule is deleted; otherwise, the flags specified by NotifyFlags are simply removed from the rule. If the flags or this rule are deleted successfully, this method returns true; otherwise, it returns false.

The Mask parameter must be the file mask of an existing rule. If a rule with the specified mask cannot be found, this method will fail.

The NotifyFlags parameter specifies which Notification Event flags should be removed from the rule. The value passed for this parameter should be constructed by ORing together zero or more of the following flags:

FS_NE_NONE0Don't fire for any filesystem operations.

Notification Events will not fire for any filesystem operations.

FS_NE_CREATE0x00000001LFire for file creation operations.

The NotifyCreateFile event will fire anytime the OS creates a file or directory. In some cases, this event can cause the NotifyOpenFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_OPEN0x00000002LFire for file open operations.

The NotifyOpenFile event will fire anytime the OS opens a file or directory. In some cases, this event can cause the NotifyCreateFile event to fire; refer to the File Create/Open Events topic for more information.

FS_NE_READ0x00000004LFire for read operations.

The NotifyReadFile event will fire anytime the OS reads data from a file.

FS_NE_WRITE0x00000008LFire for write operations.

The NotifyWriteFile event will fire anytime the OS writes data to a file.

FS_NE_LOCK_CONTROL0x00000010LFire for lock and unlock operations.

The NotifyLock, NotifyUnlockAll, NotifyUnlockAllByKey, and NotifyUnlockSingle events will fire, as applicable, anytime the OS locks or unlocks a range of bytes in a file.

FS_NE_CLEANUP0x00000020LFire for file handle cleanup operations.

The NotifyCleanupFile event will fire anytime a process closes a file or directory handle.

FS_NE_CLOSE0x00000040LFire for file close operations.

The NotifyCloseFile event will fire anytime the OS closes a file or directory.

FS_NE_CAN_DELETE0x00000080LFire for 'can be deleted' operations.

The NotifyCanFileBeDeleted event will fire anytime the OS checks whether or not a file or directory can be deleted.

FS_NE_DELETE0x00000100LFire for delete operations.

The NotifyDeleteFile event will fire anytime the OS deletes a file or directory.

FS_NE_RENAME0x00000200LFire for rename/move operations.

The NotifyRenameOrMoveFile event will fire anytime the OS renames or moves a file or directory.

FS_NE_GET_SECURITY0x00000400LFire for get security operations.

The NotifyGetFileSecurity event will fire anytime the OS queries the security attributes of a file or directory.

FS_NE_ENUMERATE_DIRECTORY0x00000800LFire for directory enumeration operations.

The NotifyEnumerateDirectory event will fire anytime the OS retrieves a directory entry during directory enumeration.

FS_NE_QUERY_FILE_INFO0x00001000LFire for QueryFileInformation operations.

The NotifyQueryFileInfo event will fire anytime the OS retrieves information about a file or directory.

FS_NE_GET_SIZES0x00002000LFire for get size operations.

The NotifyGetFileSizes event will fire anytime the OS retrieves a file's size information.

FS_NE_SET_SECURITY0x00004000LFire for set security operations.

The NotifySetFileSecurity event will fire anytime the OS changes the security attributes of a file or directory.

FS_NE_SET_ATTRIBUTES0x00008000LFire for file attribute update operations.

The NotifySetFileAttributes event will fire anytime the OS changes the attributes of a file or directory.

FS_NE_SET_SIZES0x00010000LFire for file resize operations.

The NotifySetFileSize event will fire anytime the OS resizes a file, and the NotifySetAllocationSize event will fire anytime the OS changes a file's allocation size.

FS_NE_CREATE_HARD_LINK0x00020000LFire for hard link creation operations.

The NotifyCreateHardLink event will fire anytime the OS creates a hard link.

FS_NE_FSCTL0x00040000LFire for FSCTL operations.

The NotifyFsctl event will fire anytime an IRP_MJ_FILE_SYSTEM_CONTROL operation occurs.

FS_NE_IOCTL0x00080000LFire for IOCTL operations.

The NotifyIoctl event will fire anytime an IRP_MJ_DEVICE_CONTROL operation occurs.

FS_NE_SET_FILE_INFO0x00100000LFire for SetFileInformation operations.

The NotifySetFileInfo event will fire anytime the OS changes information about a file or directory.

FS_NE_SET_EA0x00200000LFire for Set Extended Attributes operations.

The NotifySetEa event will fire anytime the OS sets extended attributes of a file.

FS_NE_QUERY_EA0x00400000LFire for Query Extended Attributes operations.

The NotifyQueryEa event will fire anytime the OS retrieves extended attributes of a file.

FS_NE_GET_REPARSE_POINT0x00800000LFire for Get Reparse Point operations.

The NotifyGetReparsePoint event will fire anytime the OS reads reparse point information of a file or directory.

FS_NE_SET_REPARSE_POINT0x01000000LFire for Set Reparse Point operations.

The NotifySetReparsePoint event will fire anytime the OS sets or updates reparse point information for a file or directory.

FS_NE_DELETE_REPARSE_POINT0x02000000LFire for Delete Reparse Point operations.

The NotifyDeleteReparsePoint event will fire anytime the OS deletes reparse point information from a file or directory.

FS_BYPASS_IO0x40000000LFire for BypassIO operations.

The BypassIORequest event will fire anytime the OS sends a BypassIO request related to some file. This flag should be passed with notification flags, even though the event is synchronous.

FS_NE_ALL-1Fire for all filesystem operations.

Notification Events will fire for all filesystem operations that the struct tracks.

To delete all passthrough rules, use the DeleteAllPassthroughRules method instead.

Note: The methods and properties related to rule management are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads (e.g., during the AfterFilterAttachToVolume and AfterFilterDetachFromVolume events) are responsible for employing proper thread synchronization techniques to ensure that manipulation and enumeration of the rule lists both occur in a thread-safe manner.

FileMatchesMask Method (CBMonitor Component)

This method checks whether a particular file or directory name matches the specified mask.

Syntax

func (obj *CBMonitor) FileMatchesMask(Mask string, FileName string, CaseSensitive bool) (bool, error)

Remarks

This method checks whether the file or directory name specified by FileName matches Mask; if it does, this method returns true. The CaseSensitive parameter controls whether a case-sensitive match should be performed.

Note: This method does not handle so-called DOS_* wildcards (DOS_STAR, DOS_QM, DOS_DOT). The explanation about the characters can be found in the MSDN article. If you have a mask that includes one of those characters on Windows, you can use the RtlIsNameInExpression function of Windows API.

Note: As the explanation states, "When you do a case-insensitive search and do not provide a translation table, the name is converted to uppercase."

GetDOSPathName Method (CBMonitor Component)

This method retrieves the DOS path name of the file or directory by its native (NT) path.

Syntax

func (obj *CBMonitor) GetDOSPathName(NTPath string) (string, error)

Remarks

This method retrieves the DOS path name of the file or directory by its native path, specified in the NTPath parameter.

Note: Such name conversion is not always possible (e.g., the volume can have none or more than one DOS names). In this case, an empty string is returned.

Note: This method can be called only within events, and it must be called in the same thread that the event was originally fired on.

GetDriverStatus Method (CBMonitor Component)

This method retrieves the status of the class's system driver.

Syntax

func (obj *CBMonitor) GetDriverStatus(ProductGUID string) (int32, error)

Remarks

This method retrieves the status of the struct's system driver. This status can then be used to verify whether it has been properly installed and is ready for use.

The value returned by the method corresponds to the dwCurrentState field of the SERVICE_STATUS structure from the Windows API. It will be one of the following:

MODULE_STATUS_NOT_PRESENT0x00000000The specified module is not present on the system.

Note: This functionality is only available in Windows.

MODULE_STATUS_STOPPED0x00000001The specified module is in the Stopped state.

Note: This functionality is only available in Windows.

MODULE_STATUS_RUNNING0x00000004The specified module is loaded and running.

Note: This functionality is only available in Windows.

ProductGUID is used to distinguish among driver installations performed by different applications. Such information is necessary to guard against unexpected situations, such as the driver being uninstalled by one application despite other applications still needing it.

Therefore, to ensure proper operation, it is critical that each individual application have its own unique ProductGUID value, and that applications (and their installation scripts) use that value when calling any of the following methods:

This method is available in both the struct API and the Installer DLL included with the product; please refer to the Driver Installation topic for more information about the latter.

Note: This method cannot be called within events.

GetDriverVersion Method (CBMonitor Component)

This method retrieves the version of the class's system driver.

Syntax

func (obj *CBMonitor) GetDriverVersion(ProductGUID string) (int64, error)

Remarks

This method retrieves the version of the struct's system driver. The value is returned as a 64-bit integer composed of four 16-bit words that each correspond to a piece of the overall module version. For example, a version of 2.32.6.28 would cause the value 0x000200200006001C to be returned.

If the struct's system driver is not installed, this method returns 0.

ProductGUID is used to distinguish among driver installations performed by different applications. Such information is necessary to guard against unexpected situations, such as the driver being uninstalled by one application despite other applications still needing it.

Therefore, to ensure proper operation, it is critical that each individual application have its own unique ProductGUID value, and that applications (and their installation scripts) use that value when calling any of the following methods:

This method is available in both the struct API and the Installer DLL included with the product; please refer to the Driver Installation topic for more information about the latter.

Note: This method cannot be called within events.

GetEventFileName Method (CBMonitor Component)

This method retrieves the name of the file or directory, to which the event applies.

Syntax

func (obj *CBMonitor) GetEventFileName() (string, error)

Remarks

This method can be called within event handlers of events, related to the file or directory operations, to retrieve the name of the file or directory, to which the operation applies. If the query fails or an event does not have an associated file name, this method returns an empty string.

GetNTPathName Method (CBMonitor Component)

This method retrieves the NT (native) path name of the file or directory by its DOS path.

Syntax

func (obj *CBMonitor) GetNTPathName(DOSPath string) (string, error)

Remarks

This method retrieves the NT (native) path name of the file or directory by its path, specified in the DOSPath parameter.

GetOperationTime Method (CBMonitor Component)

This method returns the time at which the request was received by the filter driver.

Syntax

func (obj *CBMonitor) GetOperationTime() (time.Time, error)

Remarks

This method can be called within operation-related events to retrieve the time at which the filter driver received the request. The time is recorded before an event is fired but only when the RecordOperationTime configuration setting is enabled.

The timestamps returned by this method are specified in UTC.

GetOriginatorProcessId Method (CBMonitor Component)

Retrieves the Id of the process (PID) that initiated the operation.

Syntax

func (obj *CBMonitor) GetOriginatorProcessId() (int32, error)

Remarks

This method can be called within events fired for filesystem operations to retrieve the Id of the process (PID) that initiated the operation. If the query fails, this method returns 0.

Please note that PIDs are not unique, and may be reused by different processes over time (though in practice, this is uncommon).

Applications cannot use this method to retrieve information about remote processes accessing drives shared on the network. Windows does not provide such information due to the nature of remote access.

Note: This method can be called only within events, and it must be called in the same thread that the event was originally fired on. However, it must not be called within events that work with opened files since such events can be initiated by system components (e.g., the cache manager, memory manager, etc.). If applications need the information this method returns during such events, they may do the following:

  1. Call this method within the CreateFile or OpenFile event.
  2. Store the information somewhere, and store a reference to it in the event's HandleContext parameter.
  3. In a later event, access the information via the reference stored in HandleContext.
Please refer to the Contexts topic for more information on how to use events' context parameters.

Note: Renaming and deletion of files is performed after the file is opened. Thus, access checks should be performed during file opening as described above.

Note: This method cannot be used from CleanupContext event handlers.

GetOriginatorProcessName Method (CBMonitor Component)

Retrieves the name of the process that initiated the operation.

Syntax

func (obj *CBMonitor) GetOriginatorProcessName() (string, error)

Remarks

This method can be called within events fired for filesystem operations to retrieve the name of the process that initiated the operation. If the query fails, this method returns empty string.

Applications cannot use this method to retrieve information about remote processes accessing drives shared on the network. Windows does not provide such information due to the nature of remote access.

Note: This method can be called only within events, and it must be called in the same thread that the event was originally fired on. However, it must not be called within events that work with opened files since such events can be initiated by system components (e.g., the cache manager, memory manager, etc.). If applications need the information this method returns during such events, they may do the following:

  1. Call this method within the CreateFile or OpenFile event.
  2. Store the information somewhere, and store a reference to it in the event's HandleContext parameter.
  3. In a later event, access the information via the reference stored in HandleContext.
Please refer to the Contexts topic for more information on how to use events' context parameters.

Note: Renaming and deletion of files is performed after the file is opened. Thus, access checks should be performed during file opening as described above.

Note: This method cannot be used from CleanupContext event handlers.

GetOriginatorThreadId Method (CBMonitor Component)

Retrieves the Id of the thread that initiated the operation.

Syntax

func (obj *CBMonitor) GetOriginatorThreadId() (int32, error)

Remarks

This method can be called within events fired for filesystem operations to retrieve the Id of the thread that initiated the operation. If the query fails, this method returns 0.

Please note that thread Ids are not unique, and may be reused by different threads over time.

Note: This method can be called only within events, and it must be called in the same thread that the event was originally fired on. However, it must not be called within events that work with opened files since such events can be initiated by system components (e.g., the cache manager, memory manager, etc.). If applications need the information this method returns during such events, they may do the following:

  1. Call this method within the CreateFile or OpenFile event.
  2. Store the information somewhere, and store a reference to it in the event's HandleContext parameter.
  3. In a later event, access the information via the reference stored in HandleContext.
Please refer to the Contexts topic for more information on how to use events' context parameters.

Note: Renaming and deletion of files is performed after the file is opened. Thus, access checks should be performed during file opening as described above.

Note: This method cannot be used from CleanupContext event handlers.

GetRemoteAccessInformation Method (CBMonitor Component)

This method returns networking-related information about the operation.

Syntax

func (obj *CBMonitor) GetRemoteAccessInformation(ShareName *string, ClientSocketAddressBuffer int64, ClientSocketAddressBufferSize *int32) error

Remarks

Call this method from *CreateFile/*OpenFile events to retrieve the collected networking details information related to the filesystem operation performed across the network.

Note: The information will be available only when the CollectRemoteOpenInformation configuration setting is enabled.

This method returns the contents of one of two structures, SRV_OPEN_ECP_CONTEXT or NFS_OPEN_ECP_CONTEXT. These structures contain various networking information that differs depending on the remote access type. Please refer to MSDN for additional information.

Depending on the type of remote access, the information is extracted from one of those structures. When the method returns, ShareName will contain the value of either ShareName or ExportAlias field of the corresponding structure. ClientSocketAddressBuffer will contain the value of the SocketAddress or ClientSocketAddress field of the corresponding structure. This field is a structure of the SOCKADDR_STORAGE_NFS type.

When calling the method, an application needs to prepare the buffer of the required size and specify this size of the ClientSocketAddressBuffer buffer in the ClientSocketAddressBufferSize argument.

GetVolumeGUID Method (CBMonitor Component)

This method retrieves the volume GUID of the device targeted by a filesystem operation.

Syntax

func (obj *CBMonitor) GetVolumeGUID() (string, error)

Remarks

This method can be called within events fired for filesystem operations to retrieve the volume GUID of the device targeted by the operation, returned in the Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} format. If the query fails, this method returns an empty string.

Volume GUIDs can be used to enumerate the mounting points of a device using the Windows API's GetVolumePathNamesForVolumeName function.

Note: This method can be called only within events.

Initialize Method (CBMonitor Component)

This method initializes the class.

Syntax

func (obj *CBMonitor) Initialize(ProductGUID string) error

Remarks

This method initializes the struct and must be called each time the application starts before attempting to call any of the struct's other methods with the exception of installation-related methods.

ProductGUID is used to distinguish among driver installations performed by different applications. Such information is necessary to guard against unexpected situations, such as the driver being uninstalled by one application despite other applications still needing it.

Therefore, to ensure proper operation, it is critical that each individual application have its own unique ProductGUID value, and that applications (and their installation scripts) use that value when calling any of the following methods:

If the required driver was not installed using the Install method with the same value of ProductGUID, Initialize will return a ERROR_FILE_NOT_FOUND error (Win32 error code 2).

If the loaded kernel-mode driver is older than the user-mode API, Initialize will return a ERROR_INVALID_KERNEL_INFO_VERSION error (Win32 error code 340). In this situation, an update of the driver using the Install method is required before the struct can be used.

Install Method (CBMonitor Component)

This method installs (or upgrades) the class's system driver.

Syntax

func (obj *CBMonitor) Install(CabFileName string, ProductGUID string, PathToInstall string, Altitude string, Flags int32, AllowedControllers string) (bool, error)

Remarks

This method is used to install or upgrade the struct's system driver. If the system must be rebooted to complete the installation process, this method returns true; otherwise, it returns false.

Important: To upgrade the struct's driver, use only the Install method. Previously installed versions of the driver should not be uninstalled first. Calling the Install method will upgrade the previously installed version.

Please refer to the Driver Installation topic for more information.

CabFileName must be the path of the cbfilter.cab file containing the struct's system driver.

Note: This .cab file must remain on the target system (or be available in some other way) after installation, as it is required to uninstall the driver from the system.

ProductGUID is used to distinguish among driver installations performed by different applications. Such information is necessary to guard against unexpected situations, such as the driver being uninstalled by one application despite other applications still needing it.

Therefore, to ensure proper operation, it is critical that each individual application have its own unique ProductGUID value, and that applications (and their installation scripts) use that value when calling any of the following methods:

PathToInstall controls where the driver is installed. Pass empty string (highly recommended) to automatically install them to the appropriate Windows system directory.

Altitude specifies the driver altitude to use . During development, you can use any acceptable altitude value. For deployment, an altitude value must be assigned by Microsoft before deploying a filesystem minifilter in production. After installation, the altitude can be changed at any time using the Altitude property. Please refer to the Driver Altitudes topic for more information.

Flags specifies various installation options. It should contain zero or more of the following flags, ORed together:

INSTALL_REMOVE_OLD_VERSIONS0x00000001Uninstall drivers from previous struct versions (e.g., 2017).

INSTALL_KEEP_START_TYPE0x00000002Keep the driver's current start type setting in the registry.

If this flag is not set (default), the installation logic will reset the driver's start type setting in the Windows registry to the default value. Setting this flag causes the installation logic to preserve the current value, which may be necessary if the user (or the application) set it previously.

INSTALL_OVERWRITE_SAME_VERSION0x00000004Install the driver file when its version and build number is the same as the version of the already installed driver.

INSTALL_REQUESTS_VIA_DRIVER_STACK0x00001000Whether internal requests to the filesystem are sent directly to the filesystem driver or through the stack of filesystem filter drivers.

This flag is applicable only for CBFilter and CBMonitor.

After installation, the effects of this flag can be changed using the SendRequestsViaDriverStack configuration setting.

INSTALL_ALWAYS_PREPARE_FILES0x00010000Whether the driver should keep track of information for files that are already open when (i.e., were opened before) the struct is initialized.

This flag is applicable only for CBFilter and CBMonitor.

If this flag is set, the driver will prepare information about each file as it is opened, regardless of whether a CBFilter/CBMonitor-based application is actually running at the time. This information then allows applications to receive events for any files that are already open when the CBFilter/CBMonitor struct is initialized.

Note: These preparations will slow down all file open operations; do not enable this feature unless it is actually necessary.

After installation, the effects of this flag can be changed using the AlwaysPrepareFiles configuration setting.

INSTALL_FORCE_APP_PERMISSION_CHECK0x00020000Whether the driver should require the controller process to have elevated or system privileges.

This flag is not applicable for CBProcess.

If this flag is set, the driver will verify that the controller process is a system service (or is executing with elevated privileges) anytime a file is opened. If the controller process does not meet these requirements, the file will be skipped (i.e., not filtered in any way).

Note: This additional verification will slow down all file open operations.

After installation, the effects of this flag can be changed using the ForceAppPermissionCheck configuration setting.

INSTALL_FORCE_SECURITY_CHECKS0x00040000Whether the driver should prevent the controller process from filtering files that it would not normally have access to.

This flag is not applicable for CBProcess.

If this flag is set, the driver will check the security permissions of the controller process anytime a file is opened to verify that the process has access to the file. If the controller process does not have access to the file, the file will be skipped (i.e., not filtered in any way). For example, if this flag is set and the controller process is running with limited privileges, then the driver will not allow it to filter files that require greater privileges to access.

Note: This additional verification will slow down all file open operations.

After installation, the effects of this flag can be changed using the ForceSecurityChecks configuration setting.

Note: Enabling the AlwaysPrepareFiles and/or SendRequestsViaDriverStack configuration settings before calling this method will cause the corresponding flags to be added automatically. These configuration settings can also be used to toggle the corresponding options at any time after installation.

AllowedControllers is the optional parameter that makes it possible to limit communication with the driver to just the predefined set of processes. When the caller specifies one or more names of the executable files, filtering can be started with the specified ProductGUID only when filtering is initiated by the process created from one of the listed executable files. If the name of the caller process does not match any of the allowed names, the call to StartFilter will fail with an error.

The parameter may be either empty or contain one or more EXE file names with complete paths. Separate names/paths should be separated by the LF character (numeric code 10).

This method is available in both the struct API and the Installer DLL included with the product; please refer to the Driver Installation topic for more information about the latter.

This method requires administrative rights to execute successfully. If the user account of the process that calls this method doesn't have such rights, the call will fail with an ERROR_PRIVILEGE_NOT_HELD (0x0522) error.

Note: This method cannot be called within events.

NtStatusToWin32Error Method (CBMonitor Component)

This method converts a native status code to a Win32 error code.

Syntax

func (obj *CBMonitor) NtStatusToWin32Error(Status int32) (int32, error)

Remarks

This method converts the native status code specified by Status to a Win32 error code. If the specified native status code does not map directly to a Win32 error code, this method returns ERROR_MR_MID_NOT_FOUND (317).

ShutdownSystem Method (CBMonitor Component)

Shuts down or reboots the operating system.

Syntax

func (obj *CBMonitor) ShutdownSystem(ShutdownPrompt string, Timeout int32, ForceCloseApps bool, Reboot bool) (bool, error)

Remarks

This method shuts down or (if Reboot is true) reboots the operating system. If the appropriate privileges cannot be obtained, or if the InitiateSystemShutdown system call returns false, then this method will return false; otherwise, it returns true. This method can be used if the installation or uninstallation function requires the system to be rebooted in order to complete.

ShutdownPrompt, if non-empty, specifies a message that the OS should display to the user for Timeout seconds. If empty string is passed for ShutdownPrompt, no message is displayed and the Timeout parameter's value is ignored.

ForceCloseApps specifies whether the OS should forcefully close all applications. Please keep in mind that forceful closing of applications with unsaved data can lead to data loss.

Reboot specifies whether the OS should reboot (true) or just shut down (false).

This method is available in both the struct API and the Installer DLL included with the product; please refer to the Driver Installation topic for more information about the latter.

Note: This method cannot be called within events.

StartFilter Method (CBMonitor Component)

This method starts filtering filesystem operations.

Syntax

func (obj *CBMonitor) StartFilter() error

Remarks

This method attaches the filter, causing the struct's system driver to start filtering filesystem operations according to the filter rules currently present. Rules can be added and removed both before and after this method is called, as long as the Initialize method is called before doing anything else.

This method can fail for a number of reasons, including (but not limited to) the following:

  • If the struct's system driver has not been properly installed, or is awaiting a system reboot (as indicated by the return value of Install), this method fails with an ERROR_FILE_NOT_FOUND (2) error code.
  • If the Initialize method has not been called yet, this method fails with an ERROR_NOT_READY (21) error code.
  • If the filter is already Active, this method fails with an ERROR_CONNECTION_ACTIVE (1230) error code.

StopFilter Method (CBMonitor Component)

This method stops filtering filesystem operations.

Syntax

func (obj *CBMonitor) StopFilter() error

Remarks

This method detaches the filter, causing the struct's system driver to stop filtering filesystem operations. This method will block until all pending requests have been completed and the filter has been detached.

Uninstall Method (CBMonitor Component)

This method uninstalls the class's system driver.

Syntax

func (obj *CBMonitor) Uninstall(CabFileName string, ProductGUID string, InstalledPath string, Flags int32) (bool, error)

Remarks

This method is used to uninstall the struct's system driver. If the system must be rebooted to complete the uninstallation process, this method returns true; otherwise, it returns false.

Important: To upgrade the struct's driver, use only the Install method. Previously installed versions of the driver should not be uninstalled first. Calling the Install method will upgrade the previously installed version.

Please refer to the Driver Installation topic for more information.

The same values must be passed for the CabFileName, ProductGUID, and InstalledPath parameters as were passed when Install was called; please refer to its documentation for more information.

Flags specifies which versions of the struct's system driver should be uninstalled and which should be set by ORing together one or more of the following values:

UNINSTALL_VERSION_PREVIOUS0x00000001Uninstall modules from previous product versions.

Note: This functionality is only available in Windows.

UNINSTALL_VERSION_CURRENT0x00000002Uninstall modules from the current product version.

Note: This functionality is only available in Windows.

UNINSTALL_VERSION_ALL0x00000003Uninstall modules from all product versions.

Note: This functionality is only available in Windows.

This method is available in both the struct API and the Installer DLL included with the product; please refer to the Driver Installation topic for more information about the latter.

This method requires administrative rights to execute successfully. If the user account of the process that calls this method doesn't have such rights, the call will fail with an ERROR_PRIVILEGE_NOT_HELD (0x0522) error.

Note: This method cannot be called within events.

AfterFilterAttachToVolume Event (CBMonitor Component)

This event fires after the filter attaches to a newly mounted filesystem volume.

Syntax

// CBMonitorAfterFilterAttachToVolumeEventArgs carries the CBMonitor AfterFilterAttachToVolume event's parameters.
type CBMonitorAfterFilterAttachToVolumeEventArgs struct {...}

func (args *CBMonitorAfterFilterAttachToVolumeEventArgs) VolumeName() string
func (args *CBMonitorAfterFilterAttachToVolumeEventArgs) VolumeNameNT() string
func (args *CBMonitorAfterFilterAttachToVolumeEventArgs) ResultCode() int32
func (args *CBMonitorAfterFilterAttachToVolumeEventArgs) SetResultCode(value int32)

// CBMonitorAfterFilterAttachToVolumeEvent defines the signature of the CBMonitor AfterFilterAttachToVolume event's handler function.
type CBMonitorAfterFilterAttachToVolumeEvent func(sender *CBMonitor, args *CBMonitorAfterFilterAttachToVolumeEventArgs)

func (obj *CBMonitor) GetOnAfterFilterAttachToVolumeHandler() CBMonitorAfterFilterAttachToVolumeEvent
func (obj *CBMonitor) SetOnAfterFilterAttachToVolumeHandler(handlerFunc CBMonitorAfterFilterAttachToVolumeEvent)

Remarks

This event fires after the filter attaches to the newly mounted filesystem volume specified by VolumeNameNT and, when possible, VolumeName. Please refer to the FireVolumeEvents property for more information.

Applications need to handle this event only if the FireVolumeEvents property includes the FS_MOUNT_CONTROL flag.

Note: This event won't fire for any volumes skipped during the BeforeFilterAttachToVolume event; please refer to its documentation for more information.

VolumeNameNT contains the name of the volume in the NT-native format, as received from the system. If the ResolveNtDeviceToDriveLetter configuration setting is enabled, and if it was possible to convert the NT name to the DOS format with a drive letter, VolumeName will contain the name in this format; otherwise, it will be empty.

Applications can obtain additional information about a volume by retrieving its GUID using the GetVolumeGUID method, and then using that GUID to call various Windows API functions.

Applications can use this event to add volume-specific rules for the volume that has been mounted (keeping in mind that this event does not fire for volumes that are already present when StartFilter is called). Applications that intend to do so must ensure that proper thread synchronization techniques are used when manipulating or enumerating the rule lists, because this event's handler will always execute in the context of some worker thread. Note: if a path-based rule is added or removed, such a path should use the value from VolumeNameNT to avoid a possible deadlock, which may occur during resolving a DOS name to the NT format.

Applications must be aware that this event fires as a direct response to a filesystem state change (mount or unmount). Various system components or third-party actors can perform supplementary filesystem mounting and unmounting during main unmount operations (e.g., Volume Service is one such component). This can cause seemingly excessive events to be fired, and sometimes they can be fired out of order (such as two *Attach or *Detach events fired in a row).

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource is not available or security checks failed), set it to a nonzero value to report an appropriate error. Please see the Error Handling topic for more information.

This event is fired synchronously; please refer to the Event Types topic for more information.

AfterFilterDetachFromVolume Event (CBMonitor Component)

This event fires after the filter detaches from a filesystem volume.

Syntax

// CBMonitorAfterFilterDetachFromVolumeEventArgs carries the CBMonitor AfterFilterDetachFromVolume event's parameters.
type CBMonitorAfterFilterDetachFromVolumeEventArgs struct {...}

func (args *CBMonitorAfterFilterDetachFromVolumeEventArgs) VolumeName() string
func (args *CBMonitorAfterFilterDetachFromVolumeEventArgs) VolumeNameNT() string
func (args *CBMonitorAfterFilterDetachFromVolumeEventArgs) ResultCode() int32
func (args *CBMonitorAfterFilterDetachFromVolumeEventArgs) SetResultCode(value int32)

// CBMonitorAfterFilterDetachFromVolumeEvent defines the signature of the CBMonitor AfterFilterDetachFromVolume event's handler function.
type CBMonitorAfterFilterDetachFromVolumeEvent func(sender *CBMonitor, args *CBMonitorAfterFilterDetachFromVolumeEventArgs)

func (obj *CBMonitor) GetOnAfterFilterDetachFromVolumeHandler() CBMonitorAfterFilterDetachFromVolumeEvent
func (obj *CBMonitor) SetOnAfterFilterDetachFromVolumeHandler(handlerFunc CBMonitorAfterFilterDetachFromVolumeEvent)

Remarks

This event fires after the filter detaches from the filesystem volume specified by VolumeNameNT and, when possible, VolumeName, typically because of the volume being unmounted. Please refer to the FireVolumeEvents property for more information.

Applications need to handle this event only if the FireVolumeEvents property includes the FS_MOUNT_CONTROL flag.

Note: This event won't fire for any volumes skipped during the BeforeFilterAttachToVolume event; please refer to its documentation for more information.

Applications should use this event to remove volume-specific rules for the volume that has been unmounted. Applications that intend to do so must ensure that proper thread synchronization techniques are used when manipulating or enumerating the rule lists, because this event's handler will always execute in the context of some worker thread. Note: if a path-based rule is added or removed, such a path should use the value from VolumeNameNT to avoid a possible deadlock, which may occur during resolving a DOS name to the NT format.

Applications must be aware that this event fires as a direct response to a filesystem state change (mount or unmount). Various system components or third-party actors can perform supplementary filesystem mounting and unmounting during main unmount operations (e.g., Volume Service is one such component). This can cause seemingly excessive events to be fired, and sometimes they can be fired out of order (such as two *Attach or *Detach events fired in a row).

VolumeNameNT contains the name of the volume in the NT-native format, as received from the system. If the ResolveNtDeviceToDriveLetter configuration setting is enabled, and if it was possible to convert the NT name to the DOS format with a drive letter, VolumeName will contain the name in this format; otherwise, it will be empty.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource is not available or security checks failed), set it to a nonzero value to report an appropriate error. Please see the Error Handling topic for more information.

This event is fired synchronously; please refer to the Event Types topic for more information.

BeforeFilterAttachToVolume Event (CBMonitor Component)

This event fires before the filter attaches to a newly mounted filesystem volume.

Syntax

// CBMonitorBeforeFilterAttachToVolumeEventArgs carries the CBMonitor BeforeFilterAttachToVolume event's parameters.
type CBMonitorBeforeFilterAttachToVolumeEventArgs struct {...}

func (args *CBMonitorBeforeFilterAttachToVolumeEventArgs) VolumeName() string
func (args *CBMonitorBeforeFilterAttachToVolumeEventArgs) VolumeNameNT() string
func (args *CBMonitorBeforeFilterAttachToVolumeEventArgs) SkipVolume() bool
func (args *CBMonitorBeforeFilterAttachToVolumeEventArgs) SetSkipVolume(value bool)

func (args *CBMonitorBeforeFilterAttachToVolumeEventArgs) ResultCode() int32
func (args *CBMonitorBeforeFilterAttachToVolumeEventArgs) SetResultCode(value int32)

// CBMonitorBeforeFilterAttachToVolumeEvent defines the signature of the CBMonitor BeforeFilterAttachToVolume event's handler function.
type CBMonitorBeforeFilterAttachToVolumeEvent func(sender *CBMonitor, args *CBMonitorBeforeFilterAttachToVolumeEventArgs)

func (obj *CBMonitor) GetOnBeforeFilterAttachToVolumeHandler() CBMonitorBeforeFilterAttachToVolumeEvent
func (obj *CBMonitor) SetOnBeforeFilterAttachToVolumeHandler(handlerFunc CBMonitorBeforeFilterAttachToVolumeEvent)

Remarks

This event fires before the filter attaches to the newly mounted filesystem volume specified by VolumeNameNT and, when possible, VolumeName. Please refer to the FireVolumeEvents property for more information.

Applications need to handle this event only if the FireVolumeEvents property includes the FS_MOUNT_CONTROL flag.

VolumeNameNT contains the name of the volume in the NT-native format, as received from the system. If the ResolveNtDeviceToDriveLetter configuration setting is enabled, and if it was possible to convert the NT name to the DOS format with a drive letter, VolumeName will contain the name in this format; otherwise, it will be empty.

Applications can obtain additional information about a volume by retrieving its GUID using the GetVolumeGUID method, and then using that GUID to call various Windows API functions.

The SkipVolume parameter specifies whether the struct's system driver should skip the specified volume (i.e., not attach the filter to it). Setting this parameter to true will cause all filesystem operations that target to volume to be completely ignored by the struct's system driver. It also will prevent any of the following events from firing for the volume:

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource is not available or security checks failed), set it to a nonzero value to report an appropriate error. Please see the Error Handling topic for more information.

This event is fired synchronously; please refer to the Event Types topic for more information.

Applications must be aware that this event fires as a direct response to a filesystem state change (mount or unmount). Various system components or third-party actors can perform supplementary filesystem mounting and unmounting during main unmount operations (e.g., Volume Service is one such component). This can cause seemingly excessive events to be fired, and sometimes they can be fired out of order (such as two *Attach or *Detach events fired in a row).

BypassIORequest Event (CBMonitor Component)

This event fires when the OS sends one of BypassIO commands.

Syntax

// CBMonitorBypassIORequestEventArgs carries the CBMonitor BypassIORequest event's parameters.
type CBMonitorBypassIORequestEventArgs struct {...}

func (args *CBMonitorBypassIORequestEventArgs) FileName() string
func (args *CBMonitorBypassIORequestEventArgs) RequestCode() int32
func (args *CBMonitorBypassIORequestEventArgs) Status() int32
func (args *CBMonitorBypassIORequestEventArgs) SetStatus(value int32)

func (args *CBMonitorBypassIORequestEventArgs) Reason() string
func (args *CBMonitorBypassIORequestEventArgs) SetReason(value string)

// CBMonitorBypassIORequestEvent defines the signature of the CBMonitor BypassIORequest event's handler function.
type CBMonitorBypassIORequestEvent func(sender *CBMonitor, args *CBMonitorBypassIORequestEventArgs)

func (obj *CBMonitor) GetOnBypassIORequestHandler() CBMonitorBypassIORequestEvent
func (obj *CBMonitor) SetOnBypassIORequestHandler(handlerFunc CBMonitorBypassIORequestEvent)

Remarks

This event fires when the OS sends a BypassIO request to a file specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

If BypassIO is enabled successfully future operations on the specified file handle will not be visible to the struct. To ensure all future operations on the file are visible to the struct BypassIO should not be enabled. BypassIO is present in Windows 11; it is not used in Windows 10 and earlier systems, and also is not used in Server systems.

Applications need to handle this event only if they have added a standard filter rule that includes the any of the following flags: FS_BYPASS_IO (it should be passed among notification flags), FS_CE_BEFORE_READ, FS_CE_AFTER_READ, FS_CE_BEFORE_WRITE, FS_CE_AFTER_WRITE.

The RequestCode parameter contains the code of the request. The code may be the one of the following:

BPIO_OP_ENABLE1Requests that BypassIO be enabled for the given file, which means an application might not see all non-cached reads for that file.

BPIO_OP_DISABLE2Informs that BypassIO is being disabled on the specified file.

BPIO_OP_QUERY3Queries whether BypassIO can be enabled for the given file.

BPIO_OP_VOLUME_STACK_PAUSE4Requests that BypassIO be paused on the specified volume/storage stack.

BPIO_OP_VOLUME_STACK_RESUME5Requests that BypassIO processing be resumed on the given volume.

BPIO_OP_STREAM_PAUSE6Requests that BypassIO processing be paused on a stream.

BPIO_OP_STREAM_RESUME7Requests that BypassIO processing be resumed on a stream.

BPIO_OP_GET_INFO8Requests information about the BypassIO state of the volume.

When the request code is BPIO_OP_ENABLE, an application is able to block BypassIO by specifying a non-zero value for Status and a description of the reason in the Reason parameter. If the application does so, it should return the same status and reason in response to BPIO_OP_QUERY requests to let the caller know that enabling would not be possible. BPIO_OP_QUERY requests are used, in particular, by diagnostics tools. Other operations may not be denied, and when the event is fired for one of those other operations, the struct ignores the values returned in the Status and Reason parameters.

The Status value should be one of the NTStatus codes defined in Windows SDK (Windows 11 SDK defines a group of STATUS_NOT_SUPPORTED_WITH_* constants for this).

The Reason should be set to a human-readable text that explains why BypassIO was blocked.

This event is fired synchronously; please refer to the Event Types topic for more information.

Error Event (CBMonitor Component)

This event fires if an unhandled error occurs during an event.

Syntax

// CBMonitorErrorEventArgs carries the CBMonitor Error event's parameters.
type CBMonitorErrorEventArgs struct {...}

func (args *CBMonitorErrorEventArgs) ErrorCode() int32
func (args *CBMonitorErrorEventArgs) Description() string
// CBMonitorErrorEvent defines the signature of the CBMonitor Error event's handler function.
type CBMonitorErrorEvent func(sender *CBMonitor, args *CBMonitorErrorEventArgs)

func (obj *CBMonitor) GetOnErrorHandler() CBMonitorErrorEvent
func (obj *CBMonitor) SetOnErrorHandler(handlerFunc CBMonitorErrorEvent)

Remarks

This event fires if an unhandled error occurs during another event. Developers can use this information to track down unhandled errors in an application's event handlers.

Note: Not everything is possible or allowed in the event handlers. For details, see the Recursive Calls topic.

FilterStart Event (CBMonitor Component)

This event fires once the filter has attached and filtering has started.

Syntax

// CBMonitorFilterStartEventArgs carries the CBMonitor FilterStart event's parameters.
type CBMonitorFilterStartEventArgs struct {...}

func (args *CBMonitorFilterStartEventArgs) ResultCode() int32
func (args *CBMonitorFilterStartEventArgs) SetResultCode(value int32)

// CBMonitorFilterStartEvent defines the signature of the CBMonitor FilterStart event's handler function.
type CBMonitorFilterStartEvent func(sender *CBMonitor, args *CBMonitorFilterStartEventArgs)

func (obj *CBMonitor) GetOnFilterStartHandler() CBMonitorFilterStartEvent
func (obj *CBMonitor) SetOnFilterStartHandler(handlerFunc CBMonitorFilterStartEvent)

Remarks

This event fires once the filter has attached and filtering has started; please refer to the StartFilter method for more information.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource is not available or security checks failed), set it to a nonzero value to report an appropriate error. Please see the Error Handling topic for more information.

This event is fired synchronously; please refer to the Event Types topic for more information.

FilterStop Event (CBMonitor Component)

This event fires once filtering has stopped and the filter has detached.

Syntax

// CBMonitorFilterStopEventArgs carries the CBMonitor FilterStop event's parameters.
type CBMonitorFilterStopEventArgs struct {...}

func (args *CBMonitorFilterStopEventArgs) ResultCode() int32
func (args *CBMonitorFilterStopEventArgs) SetResultCode(value int32)

// CBMonitorFilterStopEvent defines the signature of the CBMonitor FilterStop event's handler function.
type CBMonitorFilterStopEvent func(sender *CBMonitor, args *CBMonitorFilterStopEventArgs)

func (obj *CBMonitor) GetOnFilterStopHandler() CBMonitorFilterStopEvent
func (obj *CBMonitor) SetOnFilterStopHandler(handlerFunc CBMonitorFilterStopEvent)

Remarks

This event fires once filtering has stopped and the filter has detached.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired synchronously; please refer to the Event Types topic for more information.

NotifyCanFileBeDeleted Event (CBMonitor Component)

This event fires when the OS marks a file or directory for deletion or removes such a mark.

Syntax

// CBMonitorNotifyCanFileBeDeletedEventArgs carries the CBMonitor NotifyCanFileBeDeleted event's parameters.
type CBMonitorNotifyCanFileBeDeletedEventArgs struct {...}

func (args *CBMonitorNotifyCanFileBeDeletedEventArgs) FileName() string
func (args *CBMonitorNotifyCanFileBeDeletedEventArgs) RequestType() int32
func (args *CBMonitorNotifyCanFileBeDeletedEventArgs) CanDelete() bool
func (args *CBMonitorNotifyCanFileBeDeletedEventArgs) Status() int32
func (args *CBMonitorNotifyCanFileBeDeletedEventArgs) ResultCode() int32
func (args *CBMonitorNotifyCanFileBeDeletedEventArgs) SetResultCode(value int32)

// CBMonitorNotifyCanFileBeDeletedEvent defines the signature of the CBMonitor NotifyCanFileBeDeleted event's handler function.
type CBMonitorNotifyCanFileBeDeletedEvent func(sender *CBMonitor, args *CBMonitorNotifyCanFileBeDeletedEventArgs)

func (obj *CBMonitor) GetOnNotifyCanFileBeDeletedHandler() CBMonitorNotifyCanFileBeDeletedEvent
func (obj *CBMonitor) SetOnNotifyCanFileBeDeletedHandler(handlerFunc CBMonitorNotifyCanFileBeDeletedEvent)

Remarks

This event fires when the OS marks the file or directory specified by FileName for deletion or removes such a mark. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Files and directories can be deleted in two ways: (1) a file or directory can be opened with the FILE_FLAG_DELETE_ON_CLOSE flag, or (2) some process may call Windows API's NtSetInformationFile function with FILE_DISPOSITION_INFORMATION or FILE_DISPOSITION_INFORMATION_EX structure as a parameter.

If the file or directory is created or opened with the FILE_FLAG_DELETE_ON_CLOSE flag, this event is fired shortly after the NotifyCreateFile or NotifyOpenFile event.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_CAN_DELETE flag.

The RequestType indicates which kind of system request resulted in firing this event. It can be one of the following:

DEL_REQ_OPEN_FLAG0x1The file or directory is opened with the FILE_FLAG_DELETE_ON_CLOSE flag

DEL_REQ_SET_DISPOSITION0x2The system has sent the IRP_MJ_SET_INFORMATION request with SetFileDisposition structure as a parameter.

This request usually is sent using the NtSetInformationFile() Windows native API function.

The CanDelete parameter reflects whether or not the file or directory can be deleted.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyCleanupFile Event (CBMonitor Component)

This event fires when a file or directory handle has been closed.

Syntax

// CBMonitorNotifyCleanupFileEventArgs carries the CBMonitor NotifyCleanupFile event's parameters.
type CBMonitorNotifyCleanupFileEventArgs struct {...}

func (args *CBMonitorNotifyCleanupFileEventArgs) FileName() string
func (args *CBMonitorNotifyCleanupFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyCleanupFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyCleanupFileEvent defines the signature of the CBMonitor NotifyCleanupFile event's handler function.
type CBMonitorNotifyCleanupFileEvent func(sender *CBMonitor, args *CBMonitorNotifyCleanupFileEventArgs)

func (obj *CBMonitor) GetOnNotifyCleanupFileHandler() CBMonitorNotifyCleanupFileEvent
func (obj *CBMonitor) SetOnNotifyCleanupFileHandler(handlerFunc CBMonitorNotifyCleanupFileEvent)

Remarks

This event fires when a handle to the file or directory specified by FileName has been closed. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. This event differs from NotifyCloseFile in that NotifyCleanupFile fires when an open handle to the specified file or directory is closed by a process, whereas NotifyCloseFile may be fired much later when the OS itself decides that the file or directory can be formally closed.

Other events may fire for the file or directory in the time between when this event fires and when the NotifyCloseFile event fires. For example, system components, such as the memory manager or cache manager, may cause the NotifyReadFile and NotifyWriteFile events to fire.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_CLEANUP flag.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyCloseFile Event (CBMonitor Component)

This event fires when a file or directory has been closed.

Syntax

// CBMonitorNotifyCloseFileEventArgs carries the CBMonitor NotifyCloseFile event's parameters.
type CBMonitorNotifyCloseFileEventArgs struct {...}

func (args *CBMonitorNotifyCloseFileEventArgs) FileName() string
func (args *CBMonitorNotifyCloseFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyCloseFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyCloseFileEvent defines the signature of the CBMonitor NotifyCloseFile event's handler function.
type CBMonitorNotifyCloseFileEvent func(sender *CBMonitor, args *CBMonitorNotifyCloseFileEventArgs)

func (obj *CBMonitor) GetOnNotifyCloseFileHandler() CBMonitorNotifyCloseFileEvent
func (obj *CBMonitor) SetOnNotifyCloseFileHandler(handlerFunc CBMonitorNotifyCloseFileEvent)

Remarks

This event fires when the file or directory specified by FileName has been closed. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_CLOSE flag.

If the file or directory was marked for deletion earlier, the NotifyDeleteFile will fire shortly before this event.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyCreateFile Event (CBMonitor Component)

This event fires when a file or directory has been created.

Syntax

// CBMonitorNotifyCreateFileEventArgs carries the CBMonitor NotifyCreateFile event's parameters.
type CBMonitorNotifyCreateFileEventArgs struct {...}

func (args *CBMonitorNotifyCreateFileEventArgs) FileName() string
func (args *CBMonitorNotifyCreateFileEventArgs) ExistingAttributes() int32
func (args *CBMonitorNotifyCreateFileEventArgs) DesiredAccess() int32
func (args *CBMonitorNotifyCreateFileEventArgs) Attributes() int32
func (args *CBMonitorNotifyCreateFileEventArgs) ShareMode() int32
func (args *CBMonitorNotifyCreateFileEventArgs) Options() int32
func (args *CBMonitorNotifyCreateFileEventArgs) CreateDisposition() int32
func (args *CBMonitorNotifyCreateFileEventArgs) SecurityDescriptor() []byte
func (args *CBMonitorNotifyCreateFileEventArgs) Length() int32
func (args *CBMonitorNotifyCreateFileEventArgs) Status() int32
func (args *CBMonitorNotifyCreateFileEventArgs) CreationStatus() int32
func (args *CBMonitorNotifyCreateFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyCreateFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyCreateFileEvent defines the signature of the CBMonitor NotifyCreateFile event's handler function.
type CBMonitorNotifyCreateFileEvent func(sender *CBMonitor, args *CBMonitorNotifyCreateFileEventArgs)

func (obj *CBMonitor) GetOnNotifyCreateFileHandler() CBMonitorNotifyCreateFileEvent
func (obj *CBMonitor) SetOnNotifyCreateFileHandler(handlerFunc CBMonitorNotifyCreateFileEvent)

Remarks

This event fires when the file or directory specified by FileName has been created. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. Please refer to the File Create/Open Events topic for more information about how the struct determines whether to fire this event or NotifyOpenFile.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_CREATE flag.

Note: Applications must have the FilterOwnRequests configuration setting enabled if they wish to filter their own file/directory creation requests.

When extended rules are used or the AlwaysRequestAttributesOnOpen configuration setting is enabled, the driver requests attributes of the entity from the filesystem and passes them to ExistingAttributes. If the attributes are not requested, this parameter contains 0.

The DesiredAccess, Attributes, ShareMode, and CreateDisposition parameters reflect the values that were passed for the similarly named parameters of the Windows API's CreateFile function (or, more accurately, the values carried by the IRP_MJ_CREATE IRP).

DesiredAccess may contain one or more of the following access flags:

DESIRED_ACCESS_FILE_LIST_DIRECTORY0x00000001For a directory, the right to list the contents of the directory.

DESIRED_ACCESS_FILE_READ_DATA0x00000001For a file object, the right to read the corresponding file data.

For a directory object, the right to read the corresponding directory data.

DESIRED_ACCESS_FILE_ADD_FILE0x00000002For a directory, the right to create a file in the directory.

DESIRED_ACCESS_FILE_WRITE_DATA0x00000002For a file object, the right to write data to the file.

For a directory object, the right to create a file in the directory

DESIRED_ACCESS_FILE_ADD_SUBDIRECTORY0x00000004For a directory, the right to create a subdirectory.

DESIRED_ACCESS_FILE_APPEND_DATA0x00000004For a file object, the right to append data to the file.

(For local files, write operations will not overwrite existing data if this flag is specified without FILE_WRITE_DATA.) For a directory object, the right to create a subdirectory (FILE_ADD_SUBDIRECTORY).

DESIRED_ACCESS_FILE_READ_EA0x00000008The right to read extended file attributes.

DESIRED_ACCESS_FILE_WRITE_EA0x00000010The right to write extended file attributes.

DESIRED_ACCESS_FILE_EXECUTE0x00000020For a native code file, the right to execute the file.

This access right given to scripts may cause the script to be executable, depending on the script interpreter.

DESIRED_ACCESS_FILE_DELETE_CHILD0x00000040For a directory, the right to delete a directory and all the files it contains, including read-only files.

DESIRED_ACCESS_FILE_READ_ATTRIBUTES0x00000080The right to read file attributes.

DESIRED_ACCESS_FILE_WRITE_ATTRIBUTES0x00000100The right to write file attributes.

DESIRED_ACCESS_READ_CONTROL0x00020000The right to read the information in the file or directory object's security descriptor.

This does not include the information in the SACL.

DESIRED_ACCESS_STANDARD_RIGHTS_READ0x00020000Includes READ_CONTROL, which is the right to read the information in the file or directory object's security descriptor.

This does not include the information in the SACL.

DESIRED_ACCESS_STANDARD_RIGHTS_WRITE0x00020000Same as STANDARD_RIGHTS_READ

DESIRED_ACCESS_STANDARD_RIGHTS_EXECUTE0x00020000Same as STANDARD_RIGHTS_READ

DESIRED_ACCESS_SYNCHRONIZE0x00100000The right to use the object for synchronization.

This enables a thread to wait until the object is in the signaled state. Some object types do not support this access right.

DESIRED_ACCESS_FILE_ALL_ACCESS0x001F01FFAll possible access rights for a file.

DESIRED_ACCESS_FILE_GENERIC_READ0x00120089A combinarion of flags that allow reading of the file.

Note: Don't match received values against this flag. Instead, use flags that specify the rights that you want to verify or add/remove.

DESIRED_ACCESS_FILE_GENERIC_WRITE0x00120116A combinarion of flags that allow modifications to the file.

Note: Don't match received values against this flag. Instead, use flags that specify the rights that you want to verify or add/remove.

DESIRED_ACCESS_FILE_GENERIC_EXECUTE0x001200A0A combinarion of flags that allow execution of the file.

Note: Don't match received values against this flag. Instead, use flags that specify the rights that you want to verify or add/remove.

Attributes may contain one or more of the following attributes:

FILE_SYS_ATTR_READ_ONLY0x00000001The file is read-only.

Applications can read the file, but cannot write to it or delete it. This attribute is not honored on directories.

FILE_SYS_ATTR_HIDDEN0x00000002The file or directory is hidden.

The file is not included in an ordinary directory listing.

FILE_SYS_ATTR_SYSTEM0x00000004A file or directory that the operating system uses a part of, or uses exclusively.

FILE_SYS_ATTR_DIRECTORY0x00000010The entry is a directory.

FILE_SYS_ATTR_ARCHIVE0x00000020The entry is an archive file or directory.

Applications typically use this attribute to mark files for backup or removal.

FILE_SYS_ATTR_NORMAL0x00000080A file doesn't have other attributes set.

This attribute is valid only when used alone.

FILE_SYS_ATTR_TEMPORARY0x00000100A file that is being used for temporary storage.

File systems avoid writing data back to mass storage if sufficient cache memory is available, because typically, an application deletes a temporary file after the handle is closed. In that scenario, the system can entirely avoid writing the data. Otherwise, the data are written after the handle is closed.

FILE_SYS_ATTR_SPARSE_FILE0x00000200A file that is a sparse file.

FILE_SYS_ATTR_REPARSE_POINT0x00000400A file that is a reparse point or a symbolic link.

FILE_SYS_ATTR_COMPRESSED0x00000800A file or directory that is compressed.

For a file, all of the data in the file are compressed. For a directory, compression is the default for newly created files and subdirectories. A filesystem implementation can make use of this attribute by setting the SupportCompressedAttribute property to true and then properly handling the GetFileInfo, EnumerateDirectory, and SetFileAttributes events.

FILE_SYS_ATTR_OFFLINE0x00001000The data of a file are not available immediately.

This attribute indicates that the file data are physically moved to offline storage.

FILE_SYS_ATTR_NOT_CONTENT_INDEXED0x00002000The file or directory is not to be indexed by the content indexing service.

FILE_SYS_ATTR_ENCRYPTED0x00004000A file or directory that is encrypted.

For a file, all data streams in the file are encrypted. For a directory, encryption is the default for newly created files and subdirectories.

Note: This flag is used by NTFS and the OS sends undocumented requests to the filesystem based on this flag. The flag should not be used for files in custom filesystem implementations.

FILE_SYS_ATTR_VIRTUAL0x00010000Reserved.

Note: This flag is reserved by the OS and should not be used for files in custom filesystem implementations.

FILE_SYS_ATTR_RECALL_ON_OPEN0x00040000The file or directory has no physical representation on the local system; the item is virtual.

Opening the item will be more expensive than normal (e.g., it will cause at least some of it to be fetched from a remote store). This flag is reported by filesystems during directory enumerations.

ShareMode may contain zero or more of the following share mode flags:

FILESYS_SHARE_READ0x00000001Enables subsequent open operations on a file or device to request read access.

Enables subsequent open operations to request read access; otherwise, no process can open the file or device if it requests read access. If this flag is not specified, but the file or device has been opened for read access, the function fails.

FILESYS_SHARE_WRITE0x00000002Enables subsequent open operations on a file or device to request write access.

Enables subsequent open operations to request write access; otherwise, no process can open the file or device if it requests write access. If this flag is not specified, but the file or device has been opened for write access or has a file mapping with write access, the function fails.

FILESYS_SHARE_DELETE0x00000004Enables subsequent open operations on a file or device to request delete access.

Enables subsequent open operations to request delete access; otherwise, no process can open the file or device if it requests delete access. If this flag is not specified, but the file or device has been opened for delete access, the function fails.

Note: Delete access allows both delete and rename operations.

CreateDisposition may contain one of the following values:

FILE_DISPOSITION_CREATE_NEW0x00000001Creates a new file, only if it does not already exist.

If the specified file exists, the operation fails with an "already exists" error.

FILE_DISPOSITION_CREATE_ALWAYS0x00000002Creates a new file, always.

If the specified file exists and is writable, the system overwrites the file. If the specified file does not exist and is a valid path, a new file is created.

FILE_DISPOSITION_OPEN_EXISTING0x00000003Opens a file, only if it exists

If the specified file does not exist, opening fails.

FILE_DISPOSITION_OPEN_ALWAYS0x00000004Opens a file, always.

If the specified file exists, the operation succeeds. If the specified file does not exist and is a valid path to a writable location, the a file is created.

FILE_DISPOSITION_TRUNCATE_EXISTING0x00000005Opens a file and truncates it so that its size is zero bytes, only if it exists.

If the specified file does not exist, the operation fails with a "file not found" error.

Options contains the flags that are described in the CreateOptions parameter of the native API's ZwCreateFile function. Most of those flags correspond to flags passed in the FlagsAndAttributes parameter of the Windows API's CreateFile function, but some flags are specific to the native API. If you need those flags, check both functions' descriptions.

Please refer to Microsoft's documentation for detailed information about these constants.

To determine whether the request was for a file or a directory, compare Attributes against the FILE_SYS_ATTR_DIRECTORY constant, as follows: // Check whether the request is for a file or a directory. bool isDirectory = Attributes & FILE_SYS_ATTR_DIRECTORY == FILE_SYS_ATTR_DIRECTORY; FILE_SYS_ATTR_DIRECTORY will be present if it was specified by the calling process or if the existing filesystem entry is a directory.

To determine whether a file will be deleted when its last handle is closed, compare Options against the Windows API's FILE_FLAG_DELETE_ON_CLOSE constant, as follows: // Check whether the file will be deleted on close. bool deleteOnClose = Options & FILE_FLAG_DELETE_ON_CLOSE == FILE_FLAG_DELETE_ON_CLOSE; Note: Because files can be deleted in different ways, do not use this check to take actions related to tracking file deletion operations. Instead, use the events related to file deletion.

When a file or directory is created using the CreateFile() Windows API function, a caller can specify the security descriptor with the security information. This security information should be applied to a newly created file or directory. The struct passes this security information in the SecurityInformation and SecurityDescriptor parameters, when the PassSecurityInFileOpenEvents configuration setting is enabled. If this configuration setting is omitted, the corresponding parameters are empty.

The SecurityInformation parameter reflects which pieces of security information, of those present in SecurityDescriptor, are valid and should have been applied. Please refer to Microsoft's SECURITY_INFORMATION data type documentation for more information about possible values.

The SecurityDescriptor parameter points to a memory buffer that contains the security information. The Length parameter reflects the length of this data, in bytes. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The data are formatted as a SECURITY_DESCRIPTOR structure in self-relative format; please refer to the Microsoft's documentation for more information.

If the Options contains the FILE_FLAG_DELETE_ON_CLOSE flag, the NotifyCanFileBeDeleted event will fire after this event.

If the file is created with extended attributes passed in the request, the NotifySetEa event will fire after this event.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The CreationStatus parameter indicates whether the file was created or opened and can be one of the following values:

CREATION_STATUS_SUPERSEDED0x00000000An existing file was superseded by the new file.

The previous version of a file may still exist if it had hard links other than the name used in the operation.

CREATION_STATUS_OPENED0x00000001The file existed before the operation and was opened.

CREATION_STATUS_CREATED0x00000002The file didn't exist before the operation and was created.

CREATION_STATUS_OVERWRITTEN0x00000003The file exists, and its contents have been replaced.

CREATION_STATUS_EXISTS0x00000004The file existed before the operation, and no action was taken.

CREATION_STATUS_DOES_NOT_EXIST0x000000055The file did not exist before the operation, and no action was taken.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyCreateHardLink Event (CBMonitor Component)

This event fires when a hard link has been created.

Syntax

// CBMonitorNotifyCreateHardLinkEventArgs carries the CBMonitor NotifyCreateHardLink event's parameters.
type CBMonitorNotifyCreateHardLinkEventArgs struct {...}

func (args *CBMonitorNotifyCreateHardLinkEventArgs) FileName() string
func (args *CBMonitorNotifyCreateHardLinkEventArgs) LinkName() string
func (args *CBMonitorNotifyCreateHardLinkEventArgs) Status() int32
func (args *CBMonitorNotifyCreateHardLinkEventArgs) ResultCode() int32
func (args *CBMonitorNotifyCreateHardLinkEventArgs) SetResultCode(value int32)

// CBMonitorNotifyCreateHardLinkEvent defines the signature of the CBMonitor NotifyCreateHardLink event's handler function.
type CBMonitorNotifyCreateHardLinkEvent func(sender *CBMonitor, args *CBMonitorNotifyCreateHardLinkEventArgs)

func (obj *CBMonitor) GetOnNotifyCreateHardLinkHandler() CBMonitorNotifyCreateHardLinkEvent
func (obj *CBMonitor) SetOnNotifyCreateHardLinkHandler(handlerFunc CBMonitorNotifyCreateHardLinkEvent)

Remarks

This event fires when a hard link to the file specified by FileName has been created. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. Please refer to Microsoft's Hard Links article for more information about hard links.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_CREATE_HARD_LINK flag.

The LinkName parameter reflects the name of the created hard link.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyDeleteFile Event (CBMonitor Component)

This event fires when a file or directory has been deleted.

Syntax

// CBMonitorNotifyDeleteFileEventArgs carries the CBMonitor NotifyDeleteFile event's parameters.
type CBMonitorNotifyDeleteFileEventArgs struct {...}

func (args *CBMonitorNotifyDeleteFileEventArgs) FileName() string
func (args *CBMonitorNotifyDeleteFileEventArgs) RequestType() int32
func (args *CBMonitorNotifyDeleteFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyDeleteFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyDeleteFileEvent defines the signature of the CBMonitor NotifyDeleteFile event's handler function.
type CBMonitorNotifyDeleteFileEvent func(sender *CBMonitor, args *CBMonitorNotifyDeleteFileEventArgs)

func (obj *CBMonitor) GetOnNotifyDeleteFileHandler() CBMonitorNotifyDeleteFileEvent
func (obj *CBMonitor) SetOnNotifyDeleteFileHandler(handlerFunc CBMonitorNotifyDeleteFileEvent)

Remarks

This event fires when the file or directory specified by FileName has been deleted. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. More specifically, this event is queued for delivery after the final IRP_MJ_CLOSE I/O request packet (IRP) has been processed by the filesystem (i.e., after the last handle to the file or directory is closed and the file or directory is gone) and before NotifyCloseFile is queued.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_DELETE flag.

The RequestType indicates which kind of system request resulted in firing this event. It can be one of the following:

DEL_REQ_OPEN_FLAG0x1The file or directory is opened with the FILE_FLAG_DELETE_ON_CLOSE flag

DEL_REQ_SET_DISPOSITION0x2The system has sent the IRP_MJ_SET_INFORMATION request with SetFileDisposition structure as a parameter.

This request usually is sent using the NtSetInformationFile() Windows native API function.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyDeleteReparsePoint Event (CBMonitor Component)

This event fires when a file or directory's reparse point has been deleted.

Syntax

// CBMonitorNotifyDeleteReparsePointEventArgs carries the CBMonitor NotifyDeleteReparsePoint event's parameters.
type CBMonitorNotifyDeleteReparsePointEventArgs struct {...}

func (args *CBMonitorNotifyDeleteReparsePointEventArgs) FileName() string
func (args *CBMonitorNotifyDeleteReparsePointEventArgs) Status() int32
func (args *CBMonitorNotifyDeleteReparsePointEventArgs) ResultCode() int32
func (args *CBMonitorNotifyDeleteReparsePointEventArgs) SetResultCode(value int32)

// CBMonitorNotifyDeleteReparsePointEvent defines the signature of the CBMonitor NotifyDeleteReparsePoint event's handler function.
type CBMonitorNotifyDeleteReparsePointEvent func(sender *CBMonitor, args *CBMonitorNotifyDeleteReparsePointEventArgs)

func (obj *CBMonitor) GetOnNotifyDeleteReparsePointHandler() CBMonitorNotifyDeleteReparsePointEvent
func (obj *CBMonitor) SetOnNotifyDeleteReparsePointHandler(handlerFunc CBMonitorNotifyDeleteReparsePointEvent)

Remarks

This event fires when a reparse point has been deleted from the file or directory specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Note: The file or directory was not deleted, only a reparse point was.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_DELETE_REPARSE_POINT flag.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyEnumerateDirectory Event (CBMonitor Component)

This event fires when a directory entry has been returned during directory enumeration.

Syntax

// CBMonitorNotifyEnumerateDirectoryEventArgs carries the CBMonitor NotifyEnumerateDirectory event's parameters.
type CBMonitorNotifyEnumerateDirectoryEventArgs struct {...}

func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) DirectoryName() string
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) Flags() int32
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) Index() int32
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) FileName() string
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) CreationTime() time.Time
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) LastAccessTime() time.Time
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) LastWriteTime() time.Time
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) ChangeTime() time.Time
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) Size() int64
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) AllocationSize() int64
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) FileId() int64
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) Attributes() int32
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) Status() int32
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) ResultCode() int32
func (args *CBMonitorNotifyEnumerateDirectoryEventArgs) SetResultCode(value int32)

// CBMonitorNotifyEnumerateDirectoryEvent defines the signature of the CBMonitor NotifyEnumerateDirectory event's handler function.
type CBMonitorNotifyEnumerateDirectoryEvent func(sender *CBMonitor, args *CBMonitorNotifyEnumerateDirectoryEventArgs)

func (obj *CBMonitor) GetOnNotifyEnumerateDirectoryHandler() CBMonitorNotifyEnumerateDirectoryEvent
func (obj *CBMonitor) SetOnNotifyEnumerateDirectoryHandler(handlerFunc CBMonitorNotifyEnumerateDirectoryEvent)

Remarks

This event fires when a directory entry (i.e., file or subdirectory) has been returned during enumeration of the directory specified by DirectoryName. For more information about the DirectoryName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_ENUMERATE_DIRECTORY flag.

The Flags parameter specifies supplementary information about enumeration. It is a combination of zero or more values:

FS_ENUM_RESTART_SCAN1The requestor specified that directory enumeration must be restarted.

FS_ENUM_RETURN_SINGLE_ENTRY2One entry should be returned.

FS_ENUM_INDEX_SPECIFIED4The requestor specified the index to start enumeration from.

If the Flags parameter contains FS_ENUM_INDEX_SPECIFIED, the Index parameter contains the index as provided by the OS.

The FileName parameter reflects the name of the directory entry.

The CreationTime, LastAccessTime, LastWriteTime, and ChangeTime parameters reflect the entry's time values, specified in UTC.

The Size parameter reflects the size of the file, in bytes; it is always 0 for subdirectories.

The AllocationSize parameter reflects the amount of space allocated for the file, in bytes; it is always 0 for subdirectories.

The FileId parameter reflects the unique Id of the entry, as reported by the filesystem. This Id is used by the network redirector, and some third-party applications, to open files and directories by Id instead of by name. The root directory always uses the predefined Id 0x7FFFFFFFFFFFFFFF.

The Attributes parameter reflects the entry's attributes; please refer to Microsoft's File Attribute Constants article for attribute descriptions.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyFilterAttachToVolume Event (CBMonitor Component)

This event fires when the filter has been attached to a newly mounted filesystem volume.

Syntax

// CBMonitorNotifyFilterAttachToVolumeEventArgs carries the CBMonitor NotifyFilterAttachToVolume event's parameters.
type CBMonitorNotifyFilterAttachToVolumeEventArgs struct {...}

func (args *CBMonitorNotifyFilterAttachToVolumeEventArgs) VolumeName() string
func (args *CBMonitorNotifyFilterAttachToVolumeEventArgs) VolumeNameNT() string
func (args *CBMonitorNotifyFilterAttachToVolumeEventArgs) ResultCode() int32
func (args *CBMonitorNotifyFilterAttachToVolumeEventArgs) SetResultCode(value int32)

// CBMonitorNotifyFilterAttachToVolumeEvent defines the signature of the CBMonitor NotifyFilterAttachToVolume event's handler function.
type CBMonitorNotifyFilterAttachToVolumeEvent func(sender *CBMonitor, args *CBMonitorNotifyFilterAttachToVolumeEventArgs)

func (obj *CBMonitor) GetOnNotifyFilterAttachToVolumeHandler() CBMonitorNotifyFilterAttachToVolumeEvent
func (obj *CBMonitor) SetOnNotifyFilterAttachToVolumeHandler(handlerFunc CBMonitorNotifyFilterAttachToVolumeEvent)

Remarks

This event fires when the filter has been attached to the newly mounted filesystem volume specified by VolumeNameNT and, when possible, VolumeName. Please refer to the FireVolumeEvents property for more information.

Applications need to handle this event only if the FireVolumeEvents property includes the FS_MOUNT_NOTIFY flag.

Note: This event won't fire for any volumes skipped during the BeforeFilterAttachToVolume event; please refer to its documentation for more information.

VolumeNameNT contains the name of the volume in the NT-native format, as received from the system. If the ResolveNtDeviceToDriveLetter configuration setting is enabled, and if it was possible to convert the NT name to the DOS format with a drive letter, VolumeName will contain the name in this format; otherwise, it will be empty.

Applications that use volume-specific rules should typically add such rules during the AfterFilterAttachToVolume event, which is fired synchronously, rather than this one.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

Applications must be aware that this event fires as a direct response to a filesystem state change (mount or unmount). Various system components or third-party actors can perform supplementary filesystem mounting and unmounting during main unmount operations (e.g., Volume Service is one such component). This can cause seemingly excessive events to be fired, and sometimes they can be fired out of order (such as two *Attach or *Detach events fired in a row).

NotifyFilterDetachFromVolume Event (CBMonitor Component)

This event fires when the filter has been detached from a filesystem volume.

Syntax

// CBMonitorNotifyFilterDetachFromVolumeEventArgs carries the CBMonitor NotifyFilterDetachFromVolume event's parameters.
type CBMonitorNotifyFilterDetachFromVolumeEventArgs struct {...}

func (args *CBMonitorNotifyFilterDetachFromVolumeEventArgs) VolumeName() string
func (args *CBMonitorNotifyFilterDetachFromVolumeEventArgs) VolumeNameNT() string
func (args *CBMonitorNotifyFilterDetachFromVolumeEventArgs) ResultCode() int32
func (args *CBMonitorNotifyFilterDetachFromVolumeEventArgs) SetResultCode(value int32)

// CBMonitorNotifyFilterDetachFromVolumeEvent defines the signature of the CBMonitor NotifyFilterDetachFromVolume event's handler function.
type CBMonitorNotifyFilterDetachFromVolumeEvent func(sender *CBMonitor, args *CBMonitorNotifyFilterDetachFromVolumeEventArgs)

func (obj *CBMonitor) GetOnNotifyFilterDetachFromVolumeHandler() CBMonitorNotifyFilterDetachFromVolumeEvent
func (obj *CBMonitor) SetOnNotifyFilterDetachFromVolumeHandler(handlerFunc CBMonitorNotifyFilterDetachFromVolumeEvent)

Remarks

This event fires when the filter has been detached from the filesystem volume specified by VolumeNameNT and, when possible, VolumeName, typically as a result of the volume being unmounted. Please refer to the FireVolumeEvents property for more information.

Applications need to handle this event only if the FireVolumeEvents property includes the FS_MOUNT_NOTIFY flag.

Note: This event won't fire for any volumes skipped during the BeforeFilterAttachToVolume event; please refer to its documentation for more information.

VolumeNameNT contains the name of the volume in the NT-native format, as received from the system. If the ResolveNtDeviceToDriveLetter configuration setting is enabled, and if it was possible to convert the NT name to the DOS format with a drive letter, VolumeName will contain the name in this format; otherwise, it will be empty.

Applications that use volume-specific rules typically should remove such rules during the AfterFilterDetachFromVolume event, which is fired synchronously, rather than this one.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

Applications must be aware that this event fires as a direct response to a filesystem state change (mount or unmount). Various system components or third-party actors can perform supplementary filesystem mounting and unmounting during main unmount operations (e.g., Volume Service is one such component). This can cause seemingly excessive events to be fired, and sometimes they can be fired out of order (such as two *Attach or *Detach events fired in a row).

NotifyFsctl Event (CBMonitor Component)

This event fires when an IRP_MJ_FILE_SYSTEM_CONTROL operation has occurred.

Syntax

// CBMonitorNotifyFsctlEventArgs carries the CBMonitor NotifyFsctl event's parameters.
type CBMonitorNotifyFsctlEventArgs struct {...}

func (args *CBMonitorNotifyFsctlEventArgs) FileName() string
func (args *CBMonitorNotifyFsctlEventArgs) FsControlCode() int32
func (args *CBMonitorNotifyFsctlEventArgs) InBuffer() []byte
func (args *CBMonitorNotifyFsctlEventArgs) InBufferLength() int32
func (args *CBMonitorNotifyFsctlEventArgs) InBufferValidBytes() int32
func (args *CBMonitorNotifyFsctlEventArgs) OutBuffer() []byte
func (args *CBMonitorNotifyFsctlEventArgs) OutBufferLength() int32
func (args *CBMonitorNotifyFsctlEventArgs) OutBufferValidBytes() int32
func (args *CBMonitorNotifyFsctlEventArgs) Status() int32
func (args *CBMonitorNotifyFsctlEventArgs) ResultCode() int32
func (args *CBMonitorNotifyFsctlEventArgs) SetResultCode(value int32)

// CBMonitorNotifyFsctlEvent defines the signature of the CBMonitor NotifyFsctl event's handler function.
type CBMonitorNotifyFsctlEvent func(sender *CBMonitor, args *CBMonitorNotifyFsctlEventArgs)

func (obj *CBMonitor) GetOnNotifyFsctlHandler() CBMonitorNotifyFsctlEvent
func (obj *CBMonitor) SetOnNotifyFsctlHandler(handlerFunc CBMonitorNotifyFsctlEvent)

Remarks

This event fires when an IRP_MJ_FILE_SYSTEM_CONTROL (FSCTL) operation has occurred. Such requests are sent using the Windows API's DeviceIoControl function (user mode), or ZwFsControlFile function (kernel mode); please refer to Microsoft's documentation for more information.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_FSCTL flag.

The FileName parameter reflects the file, directory, or volume targeted by the request.

The FsControlCode parameter reflects the requested filesystem control code (FSCTL).

The InBuffer parameter points to a memory buffer that contains the data required to perform the operation. The InBufferLength and InBufferValidBytes parameters reflect the capacity of InBuffer and the length of the data it contains (respectively), in bytes; InBufferValidBytes may be less than InBufferLength (unless the request did not include data, in which case both will be 0).

The OutBuffer parameter points to a memory buffer that contains the data returned by the operation. The OutBufferLength and OutBufferValidBytes parameters reflect the capacity of OutBuffer and the length of the data it contains (respectively), in bytes; OutBufferValidBytes may be less than OutBufferLength (unless the operation did not return data, in which case both will be 0).

Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyGetFileSecurity Event (CBMonitor Component)

This event fires when a file or directory's security attributes have been retrieved.

Syntax

// CBMonitorNotifyGetFileSecurityEventArgs carries the CBMonitor NotifyGetFileSecurity event's parameters.
type CBMonitorNotifyGetFileSecurityEventArgs struct {...}

func (args *CBMonitorNotifyGetFileSecurityEventArgs) FileName() string
func (args *CBMonitorNotifyGetFileSecurityEventArgs) SecurityInformation() int32
func (args *CBMonitorNotifyGetFileSecurityEventArgs) SecurityDescriptor() []byte
func (args *CBMonitorNotifyGetFileSecurityEventArgs) Length() int32
func (args *CBMonitorNotifyGetFileSecurityEventArgs) Status() int32
func (args *CBMonitorNotifyGetFileSecurityEventArgs) ResultCode() int32
func (args *CBMonitorNotifyGetFileSecurityEventArgs) SetResultCode(value int32)

// CBMonitorNotifyGetFileSecurityEvent defines the signature of the CBMonitor NotifyGetFileSecurity event's handler function.
type CBMonitorNotifyGetFileSecurityEvent func(sender *CBMonitor, args *CBMonitorNotifyGetFileSecurityEventArgs)

func (obj *CBMonitor) GetOnNotifyGetFileSecurityHandler() CBMonitorNotifyGetFileSecurityEvent
func (obj *CBMonitor) SetOnNotifyGetFileSecurityHandler(handlerFunc CBMonitorNotifyGetFileSecurityEvent)

Remarks

This event fires when security attributes have been retrieved for the file or directory specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Note: This event will not fire every time a file or directory is accessed. To check file security upon each access to a file or directory, implement the file create and open events and perform the necessary checks there instead.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_GET_SECURITY flag.

The SecurityInformation parameter indicates which pieces of security information were requested. Please refer to Microsoft's SECURITY_INFORMATION data-type documentation for more information about possible values.

The SecurityDescriptor parameter points to a memory buffer that, if the request was successful, contains the requested security information. The Length parameter reflects the length of this data, in bytes. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The data are formatted as a SECURITY_DESCRIPTOR structure in self-relative format; please refer to the Microsoft's documentation for more information.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyGetFileSizes Event (CBMonitor Component)

This event fires when a file's size information has been retrieved.

Syntax

// CBMonitorNotifyGetFileSizesEventArgs carries the CBMonitor NotifyGetFileSizes event's parameters.
type CBMonitorNotifyGetFileSizesEventArgs struct {...}

func (args *CBMonitorNotifyGetFileSizesEventArgs) FileName() string
func (args *CBMonitorNotifyGetFileSizesEventArgs) Size() int64
func (args *CBMonitorNotifyGetFileSizesEventArgs) AllocationSize() int64
func (args *CBMonitorNotifyGetFileSizesEventArgs) Status() int32
func (args *CBMonitorNotifyGetFileSizesEventArgs) ResultCode() int32
func (args *CBMonitorNotifyGetFileSizesEventArgs) SetResultCode(value int32)

// CBMonitorNotifyGetFileSizesEvent defines the signature of the CBMonitor NotifyGetFileSizes event's handler function.
type CBMonitorNotifyGetFileSizesEvent func(sender *CBMonitor, args *CBMonitorNotifyGetFileSizesEventArgs)

func (obj *CBMonitor) GetOnNotifyGetFileSizesHandler() CBMonitorNotifyGetFileSizesEvent
func (obj *CBMonitor) SetOnNotifyGetFileSizesHandler(handlerFunc CBMonitorNotifyGetFileSizesEvent)

Remarks

This event fires when size information has been retrieved for the file specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_GET_SIZES flag.

The Size parameter reflects the actual size of the file, in bytes.

The AllocationSize parameter reflects the amount of space allocated for the file, in bytes.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyGetReparsePoint Event (CBMonitor Component)

This event fires when a file or directory's reparse point information has been retrieved.

Syntax

// CBMonitorNotifyGetReparsePointEventArgs carries the CBMonitor NotifyGetReparsePoint event's parameters.
type CBMonitorNotifyGetReparsePointEventArgs struct {...}

func (args *CBMonitorNotifyGetReparsePointEventArgs) FileName() string
func (args *CBMonitorNotifyGetReparsePointEventArgs) Status() int32
func (args *CBMonitorNotifyGetReparsePointEventArgs) ResultCode() int32
func (args *CBMonitorNotifyGetReparsePointEventArgs) SetResultCode(value int32)

// CBMonitorNotifyGetReparsePointEvent defines the signature of the CBMonitor NotifyGetReparsePoint event's handler function.
type CBMonitorNotifyGetReparsePointEvent func(sender *CBMonitor, args *CBMonitorNotifyGetReparsePointEventArgs)

func (obj *CBMonitor) GetOnNotifyGetReparsePointHandler() CBMonitorNotifyGetReparsePointEvent
func (obj *CBMonitor) SetOnNotifyGetReparsePointHandler(handlerFunc CBMonitorNotifyGetReparsePointEvent)

Remarks

This event fires when reparse point information has been retrieved for the file or directory specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_GET_REPARSE_POINT flag.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyIoctl Event (CBMonitor Component)

This event fires when an IRP_MJ_DEVICE_CONTROL operation has occurred.

Syntax

// CBMonitorNotifyIoctlEventArgs carries the CBMonitor NotifyIoctl event's parameters.
type CBMonitorNotifyIoctlEventArgs struct {...}

func (args *CBMonitorNotifyIoctlEventArgs) FileName() string
func (args *CBMonitorNotifyIoctlEventArgs) IoControlCode() int32
func (args *CBMonitorNotifyIoctlEventArgs) InBuffer() []byte
func (args *CBMonitorNotifyIoctlEventArgs) InBufferLength() int32
func (args *CBMonitorNotifyIoctlEventArgs) InBufferValidBytes() int32
func (args *CBMonitorNotifyIoctlEventArgs) OutBuffer() []byte
func (args *CBMonitorNotifyIoctlEventArgs) OutBufferLength() int32
func (args *CBMonitorNotifyIoctlEventArgs) OutBufferValidBytes() int32
func (args *CBMonitorNotifyIoctlEventArgs) Status() int32
func (args *CBMonitorNotifyIoctlEventArgs) ResultCode() int32
func (args *CBMonitorNotifyIoctlEventArgs) SetResultCode(value int32)

// CBMonitorNotifyIoctlEvent defines the signature of the CBMonitor NotifyIoctl event's handler function.
type CBMonitorNotifyIoctlEvent func(sender *CBMonitor, args *CBMonitorNotifyIoctlEventArgs)

func (obj *CBMonitor) GetOnNotifyIoctlHandler() CBMonitorNotifyIoctlEvent
func (obj *CBMonitor) SetOnNotifyIoctlHandler(handlerFunc CBMonitorNotifyIoctlEvent)

Remarks

This event fires when an IRP_MJ_DEVICE_CONTROL (IOCTL) operation has occurred. Such requests are sent using the Windows API's DeviceIoControl function (user mode), or ZwDeviceIoControlFile function (kernel mode). Please refer to Microsoft's documentation for more information.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_IOCTL flag.

The FileName parameter reflects the file, directory, or volume targeted by the request.

The IoControlCode parameter reflects the requested I/O control code (IOCTL).

The InBuffer parameter points to a memory buffer that contains the data required to perform the operation. The InBufferLength and InBufferValidBytes parameters reflect the capacity of InBuffer and the length of the data it contains (respectively), in bytes; InBufferValidBytes may be less than InBufferLength (unless the request did not include data, in which case both will be 0).

The OutBuffer parameter points to a memory buffer that contains the data returned by the operation. The OutBufferLength and OutBufferValidBytes parameters reflect the capacity of OutBuffer and the length of the data it contains (respectively), in bytes; OutBufferValidBytes may be less than OutBufferLength (unless the operation did not return data, in which case both will be 0).

Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyLock Event (CBMonitor Component)

This event fires when a range of bytes in a file has been locked.

Syntax

// CBMonitorNotifyLockEventArgs carries the CBMonitor NotifyLock event's parameters.
type CBMonitorNotifyLockEventArgs struct {...}

func (args *CBMonitorNotifyLockEventArgs) FileName() string
func (args *CBMonitorNotifyLockEventArgs) Offset() int64
func (args *CBMonitorNotifyLockEventArgs) Length() int64
func (args *CBMonitorNotifyLockEventArgs) Key() int64
func (args *CBMonitorNotifyLockEventArgs) FailImmediately() bool
func (args *CBMonitorNotifyLockEventArgs) ExclusiveLock() bool
func (args *CBMonitorNotifyLockEventArgs) Status() int32
func (args *CBMonitorNotifyLockEventArgs) ResultCode() int32
func (args *CBMonitorNotifyLockEventArgs) SetResultCode(value int32)

// CBMonitorNotifyLockEvent defines the signature of the CBMonitor NotifyLock event's handler function.
type CBMonitorNotifyLockEvent func(sender *CBMonitor, args *CBMonitorNotifyLockEventArgs)

func (obj *CBMonitor) GetOnNotifyLockHandler() CBMonitorNotifyLockEvent
func (obj *CBMonitor) SetOnNotifyLockHandler(handlerFunc CBMonitorNotifyLockEvent)

Remarks

This event fires when a range of bytes in the file specified by FileName has been locked. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. This request is made either by the OS, or on behalf of a user mode application that called the Windows API's LockFile or LockFileEx function.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_LOCK_CONTROL flag.

The Offset parameter reflects the byte offset where the byte range lock starts.

The Length parameter reflects the length of the byte range lock.

The Key parameter reflects the key that the byte range lock is associated with. This key is used to identify the byte range lock in later unlock-by-key requests.

The FailImmediately parameter indicates whether the request was to fail if the lock could not be granted immediately.

The ExclusiveLock parameter indicates whether the byte range lock was to be exclusive (true) or shared (false).

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyOpenFile Event (CBMonitor Component)

This event fires when a file or directory has been opened.

Syntax

// CBMonitorNotifyOpenFileEventArgs carries the CBMonitor NotifyOpenFile event's parameters.
type CBMonitorNotifyOpenFileEventArgs struct {...}

func (args *CBMonitorNotifyOpenFileEventArgs) FileName() string
func (args *CBMonitorNotifyOpenFileEventArgs) ExistingAttributes() int32
func (args *CBMonitorNotifyOpenFileEventArgs) DesiredAccess() int32
func (args *CBMonitorNotifyOpenFileEventArgs) Attributes() int32
func (args *CBMonitorNotifyOpenFileEventArgs) ShareMode() int32
func (args *CBMonitorNotifyOpenFileEventArgs) Options() int32
func (args *CBMonitorNotifyOpenFileEventArgs) CreateDisposition() int32
func (args *CBMonitorNotifyOpenFileEventArgs) SecurityDescriptor() []byte
func (args *CBMonitorNotifyOpenFileEventArgs) Length() int32
func (args *CBMonitorNotifyOpenFileEventArgs) Status() int32
func (args *CBMonitorNotifyOpenFileEventArgs) CreationStatus() int32
func (args *CBMonitorNotifyOpenFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyOpenFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyOpenFileEvent defines the signature of the CBMonitor NotifyOpenFile event's handler function.
type CBMonitorNotifyOpenFileEvent func(sender *CBMonitor, args *CBMonitorNotifyOpenFileEventArgs)

func (obj *CBMonitor) GetOnNotifyOpenFileHandler() CBMonitorNotifyOpenFileEvent
func (obj *CBMonitor) SetOnNotifyOpenFileHandler(handlerFunc CBMonitorNotifyOpenFileEvent)

Remarks

This event fires when the file or directory specified by FileName has been opened. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. Please refer to the File Create/Open Events topic for more information about how the struct determines whether to fire this event or NotifyCreateFile.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_OPEN flag.

Note: Applications must have the FilterOwnRequests configuration setting enabled if they wish to filter their own file/directory open requests.

When extended rules are used or the AlwaysRequestAttributesOnOpen configuration setting is enabled, the driver requests attributes of the entity from the filesystem and passes them to ExistingAttributes. If the attributes are not requested, this parameter contains 0.

The DesiredAccess, Attributes, ShareMode, and CreateDisposition parameters reflect the values that were passed for the similarly named parameters of the Windows API's CreateFile function (or, more accurately, the values carried by the IRP_MJ_CREATE IRP).

DesiredAccess may contain one or more of the following access flags:

DESIRED_ACCESS_FILE_LIST_DIRECTORY0x00000001For a directory, the right to list the contents of the directory.

DESIRED_ACCESS_FILE_READ_DATA0x00000001For a file object, the right to read the corresponding file data.

For a directory object, the right to read the corresponding directory data.

DESIRED_ACCESS_FILE_ADD_FILE0x00000002For a directory, the right to create a file in the directory.

DESIRED_ACCESS_FILE_WRITE_DATA0x00000002For a file object, the right to write data to the file.

For a directory object, the right to create a file in the directory

DESIRED_ACCESS_FILE_ADD_SUBDIRECTORY0x00000004For a directory, the right to create a subdirectory.

DESIRED_ACCESS_FILE_APPEND_DATA0x00000004For a file object, the right to append data to the file.

(For local files, write operations will not overwrite existing data if this flag is specified without FILE_WRITE_DATA.) For a directory object, the right to create a subdirectory (FILE_ADD_SUBDIRECTORY).

DESIRED_ACCESS_FILE_READ_EA0x00000008The right to read extended file attributes.

DESIRED_ACCESS_FILE_WRITE_EA0x00000010The right to write extended file attributes.

DESIRED_ACCESS_FILE_EXECUTE0x00000020For a native code file, the right to execute the file.

This access right given to scripts may cause the script to be executable, depending on the script interpreter.

DESIRED_ACCESS_FILE_DELETE_CHILD0x00000040For a directory, the right to delete a directory and all the files it contains, including read-only files.

DESIRED_ACCESS_FILE_READ_ATTRIBUTES0x00000080The right to read file attributes.

DESIRED_ACCESS_FILE_WRITE_ATTRIBUTES0x00000100The right to write file attributes.

DESIRED_ACCESS_READ_CONTROL0x00020000The right to read the information in the file or directory object's security descriptor.

This does not include the information in the SACL.

DESIRED_ACCESS_STANDARD_RIGHTS_READ0x00020000Includes READ_CONTROL, which is the right to read the information in the file or directory object's security descriptor.

This does not include the information in the SACL.

DESIRED_ACCESS_STANDARD_RIGHTS_WRITE0x00020000Same as STANDARD_RIGHTS_READ

DESIRED_ACCESS_STANDARD_RIGHTS_EXECUTE0x00020000Same as STANDARD_RIGHTS_READ

DESIRED_ACCESS_SYNCHRONIZE0x00100000The right to use the object for synchronization.

This enables a thread to wait until the object is in the signaled state. Some object types do not support this access right.

DESIRED_ACCESS_FILE_ALL_ACCESS0x001F01FFAll possible access rights for a file.

DESIRED_ACCESS_FILE_GENERIC_READ0x00120089A combinarion of flags that allow reading of the file.

Note: Don't match received values against this flag. Instead, use flags that specify the rights that you want to verify or add/remove.

DESIRED_ACCESS_FILE_GENERIC_WRITE0x00120116A combinarion of flags that allow modifications to the file.

Note: Don't match received values against this flag. Instead, use flags that specify the rights that you want to verify or add/remove.

DESIRED_ACCESS_FILE_GENERIC_EXECUTE0x001200A0A combinarion of flags that allow execution of the file.

Note: Don't match received values against this flag. Instead, use flags that specify the rights that you want to verify or add/remove.

Attributes may contain one or more of the following attributes:

FILE_SYS_ATTR_READ_ONLY0x00000001The file is read-only.

Applications can read the file, but cannot write to it or delete it. This attribute is not honored on directories.

FILE_SYS_ATTR_HIDDEN0x00000002The file or directory is hidden.

The file is not included in an ordinary directory listing.

FILE_SYS_ATTR_SYSTEM0x00000004A file or directory that the operating system uses a part of, or uses exclusively.

FILE_SYS_ATTR_DIRECTORY0x00000010The entry is a directory.

FILE_SYS_ATTR_ARCHIVE0x00000020The entry is an archive file or directory.

Applications typically use this attribute to mark files for backup or removal.

FILE_SYS_ATTR_NORMAL0x00000080A file doesn't have other attributes set.

This attribute is valid only when used alone.

FILE_SYS_ATTR_TEMPORARY0x00000100A file that is being used for temporary storage.

File systems avoid writing data back to mass storage if sufficient cache memory is available, because typically, an application deletes a temporary file after the handle is closed. In that scenario, the system can entirely avoid writing the data. Otherwise, the data are written after the handle is closed.

FILE_SYS_ATTR_SPARSE_FILE0x00000200A file that is a sparse file.

FILE_SYS_ATTR_REPARSE_POINT0x00000400A file that is a reparse point or a symbolic link.

FILE_SYS_ATTR_COMPRESSED0x00000800A file or directory that is compressed.

For a file, all of the data in the file are compressed. For a directory, compression is the default for newly created files and subdirectories. A filesystem implementation can make use of this attribute by setting the SupportCompressedAttribute property to true and then properly handling the GetFileInfo, EnumerateDirectory, and SetFileAttributes events.

FILE_SYS_ATTR_OFFLINE0x00001000The data of a file are not available immediately.

This attribute indicates that the file data are physically moved to offline storage.

FILE_SYS_ATTR_NOT_CONTENT_INDEXED0x00002000The file or directory is not to be indexed by the content indexing service.

FILE_SYS_ATTR_ENCRYPTED0x00004000A file or directory that is encrypted.

For a file, all data streams in the file are encrypted. For a directory, encryption is the default for newly created files and subdirectories.

Note: This flag is used by NTFS and the OS sends undocumented requests to the filesystem based on this flag. The flag should not be used for files in custom filesystem implementations.

FILE_SYS_ATTR_VIRTUAL0x00010000Reserved.

Note: This flag is reserved by the OS and should not be used for files in custom filesystem implementations.

FILE_SYS_ATTR_RECALL_ON_OPEN0x00040000The file or directory has no physical representation on the local system; the item is virtual.

Opening the item will be more expensive than normal (e.g., it will cause at least some of it to be fetched from a remote store). This flag is reported by filesystems during directory enumerations.

ShareMode may contain zero or more of the following share mode flags:

FILESYS_SHARE_READ0x00000001Enables subsequent open operations on a file or device to request read access.

Enables subsequent open operations to request read access; otherwise, no process can open the file or device if it requests read access. If this flag is not specified, but the file or device has been opened for read access, the function fails.

FILESYS_SHARE_WRITE0x00000002Enables subsequent open operations on a file or device to request write access.

Enables subsequent open operations to request write access; otherwise, no process can open the file or device if it requests write access. If this flag is not specified, but the file or device has been opened for write access or has a file mapping with write access, the function fails.

FILESYS_SHARE_DELETE0x00000004Enables subsequent open operations on a file or device to request delete access.

Enables subsequent open operations to request delete access; otherwise, no process can open the file or device if it requests delete access. If this flag is not specified, but the file or device has been opened for delete access, the function fails.

Note: Delete access allows both delete and rename operations.

CreateDisposition may contain one of the following values:

FILE_DISPOSITION_CREATE_NEW0x00000001Creates a new file, only if it does not already exist.

If the specified file exists, the operation fails with an "already exists" error.

FILE_DISPOSITION_CREATE_ALWAYS0x00000002Creates a new file, always.

If the specified file exists and is writable, the system overwrites the file. If the specified file does not exist and is a valid path, a new file is created.

FILE_DISPOSITION_OPEN_EXISTING0x00000003Opens a file, only if it exists

If the specified file does not exist, opening fails.

FILE_DISPOSITION_OPEN_ALWAYS0x00000004Opens a file, always.

If the specified file exists, the operation succeeds. If the specified file does not exist and is a valid path to a writable location, the a file is created.

FILE_DISPOSITION_TRUNCATE_EXISTING0x00000005Opens a file and truncates it so that its size is zero bytes, only if it exists.

If the specified file does not exist, the operation fails with a "file not found" error.

Options contains the flags that are described in the CreateOptions parameter of the native API's ZwCreateFile function. Most of those flags correspond to flags passed in the FlagsAndAttributes parameter of the Windows API's CreateFile function, but some flags are specific to the native API. If you need those flags, check both functions' descriptions.

Please refer to Microsoft's documentation for detailed information about these constants.

To determine whether the request was for a file or a directory, compare Attributes against the FILE_SYS_ATTR_DIRECTORY constant, as follows: // Check whether the request is for a file or a directory. bool isDirectory = Attributes & FILE_SYS_ATTR_DIRECTORY == FILE_SYS_ATTR_DIRECTORY; FILE_SYS_ATTR_DIRECTORY will be present if it was specified by the calling process or if the existing filesystem entry is a directory.

To determine whether a file will be deleted when its last handle is closed, compare Options against the Windows API's FILE_FLAG_DELETE_ON_CLOSE constant, as follows: // Check whether the file will be deleted on close. bool deleteOnClose = Options & FILE_FLAG_DELETE_ON_CLOSE == FILE_FLAG_DELETE_ON_CLOSE; Note: Because files can be deleted in different ways, do not use this check to take actions related to tracking file deletion operations. Instead, use the events related to file deletion.

When a file or directory is created using the CreateFile() Windows API function, a caller can specify the security descriptor with the security information. This security information should be applied to a newly created file or directory. The struct passes this security information in the SecurityInformation and SecurityDescriptor parameters, when the PassSecurityInFileOpenEvents configuration setting is enabled. If this configuration setting is omitted, the corresponding parameters are empty.

The SecurityInformation parameter reflects which pieces of security information, of those present in SecurityDescriptor, are valid and should have been applied. Please refer to Microsoft's SECURITY_INFORMATION data type documentation for more information about possible values.

The SecurityDescriptor parameter points to a memory buffer that contains the security information. The Length parameter reflects the length of this data, in bytes. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The data are formatted as a SECURITY_DESCRIPTOR structure in self-relative format; please refer to the Microsoft's documentation for more information.

If the Options contains the FILE_FLAG_DELETE_ON_CLOSE flag, the NotifyCanFileBeDeleted event will fire after this event.

If the file is opened with extended attributes passed in the request, the NotifySetEa event will fire after this event.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The CreationStatus parameter indicates whether the file was created or opened and can be one of the following values:

CREATION_STATUS_SUPERSEDED0x00000000An existing file was superseded by the new file.

The previous version of a file may still exist if it had hard links other than the name used in the operation.

CREATION_STATUS_OPENED0x00000001The file existed before the operation and was opened.

CREATION_STATUS_CREATED0x00000002The file didn't exist before the operation and was created.

CREATION_STATUS_OVERWRITTEN0x00000003The file exists, and its contents have been replaced.

CREATION_STATUS_EXISTS0x00000004The file existed before the operation, and no action was taken.

CREATION_STATUS_DOES_NOT_EXIST0x000000055The file did not exist before the operation, and no action was taken.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyQueryEa Event (CBMonitor Component)

This event fires when information about the extended attributes of a file has been retrieved.

Syntax

// CBMonitorNotifyQueryEaEventArgs carries the CBMonitor NotifyQueryEa event's parameters.
type CBMonitorNotifyQueryEaEventArgs struct {...}

func (args *CBMonitorNotifyQueryEaEventArgs) FileName() string
func (args *CBMonitorNotifyQueryEaEventArgs) Buffer() []byte
func (args *CBMonitorNotifyQueryEaEventArgs) BufferLength() int32
func (args *CBMonitorNotifyQueryEaEventArgs) ReturnSingleEntry() bool
func (args *CBMonitorNotifyQueryEaEventArgs) EaList() []byte
func (args *CBMonitorNotifyQueryEaEventArgs) EaListLength() int32
func (args *CBMonitorNotifyQueryEaEventArgs) EaIndex() int32
func (args *CBMonitorNotifyQueryEaEventArgs) RestartScan() bool
func (args *CBMonitorNotifyQueryEaEventArgs) LengthReturned() int32
func (args *CBMonitorNotifyQueryEaEventArgs) Status() int32
func (args *CBMonitorNotifyQueryEaEventArgs) ResultCode() int32
func (args *CBMonitorNotifyQueryEaEventArgs) SetResultCode(value int32)

// CBMonitorNotifyQueryEaEvent defines the signature of the CBMonitor NotifyQueryEa event's handler function.
type CBMonitorNotifyQueryEaEvent func(sender *CBMonitor, args *CBMonitorNotifyQueryEaEventArgs)

func (obj *CBMonitor) GetOnNotifyQueryEaHandler() CBMonitorNotifyQueryEaEvent
func (obj *CBMonitor) SetOnNotifyQueryEaHandler(handlerFunc CBMonitorNotifyQueryEaEvent)

Remarks

This event fires when information about the extended attributes of a file specified by FileName has been retrieved. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_QUERY_EA flag.

The Buffer parameter points to a memory buffer that, if the request was successful, contains the requested information. The data in the buffer are formatted as a FILE_FULL_EA_INFORMATION structure; please refer to the Microsoft's documentation for more information. The Length parameter reflects the length of this buffer, in bytes. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

ReturnSingleEntry specifies that the filesystem had to return only the first entry it has found.

EaList is an optional parameter that points to a caller-supplied memory buffer specifying the extended attributes to be queried. The data in the buffer are formatted as a FILE_GET_EA_INFORMATION structure; please refer to the Microsoft's documentation for more information. The EaListLength parameter reflects the length of this data, in bytes. If the caller of the FltQueryEaFile function did not specify any value, it will contain 0.

EaIndex is an optional parameter that specifies the starting index of the attribute, information about which was requested. This parameter is ignored by the filesystem if EaList points to a nonempty list. If the caller of the FltQueryEaFile function did not specify any value, the parameter will contain -1.

The RestartScan parameter instructs the filesystem to restart enumeration of extended attributes from the first entry. If the parameter is false, retrieval of the extended attributes is resumed by the filesystem after a previous request.

LengthReturned is an optional parameter that contains the size, in bytes, of the information, returned in the Buffer.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyQueryFileInfo Event (CBMonitor Component)

This event fires when information about a file or directory has been retrieved.

Syntax

// CBMonitorNotifyQueryFileInfoEventArgs carries the CBMonitor NotifyQueryFileInfo event's parameters.
type CBMonitorNotifyQueryFileInfoEventArgs struct {...}

func (args *CBMonitorNotifyQueryFileInfoEventArgs) FileName() string
func (args *CBMonitorNotifyQueryFileInfoEventArgs) FileInformationClass() int32
func (args *CBMonitorNotifyQueryFileInfoEventArgs) Buffer() []byte
func (args *CBMonitorNotifyQueryFileInfoEventArgs) BufferLength() int32
func (args *CBMonitorNotifyQueryFileInfoEventArgs) ValidBytes() int32
func (args *CBMonitorNotifyQueryFileInfoEventArgs) Status() int32
func (args *CBMonitorNotifyQueryFileInfoEventArgs) ResultCode() int32
func (args *CBMonitorNotifyQueryFileInfoEventArgs) SetResultCode(value int32)

// CBMonitorNotifyQueryFileInfoEvent defines the signature of the CBMonitor NotifyQueryFileInfo event's handler function.
type CBMonitorNotifyQueryFileInfoEvent func(sender *CBMonitor, args *CBMonitorNotifyQueryFileInfoEventArgs)

func (obj *CBMonitor) GetOnNotifyQueryFileInfoHandler() CBMonitorNotifyQueryFileInfoEvent
func (obj *CBMonitor) SetOnNotifyQueryFileInfoHandler(handlerFunc CBMonitorNotifyQueryFileInfoEvent)

Remarks

This event fires when information about a file or directory specified by FileName has been retrieved. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. This event typically fires in response to the Windows API's NtQueryInformationFile function.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_QUERY_FILE_INFO flag.

The FileInformationClass parameter indicates what kind of file information was requested. Please refer to the NtQueryInformationFile function's documentation for more information about possible values.

The Buffer parameter points to a memory buffer that, if the request was successful, contains the requested file information. The BufferLength and ValidBytes parameters reflect the capacity of Buffer and the length of the data it contains (respectively), in bytes; ValidBytes may be less than BufferLength. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The format of the data is determined by the specified FileInformationClass; please refer to the NtQueryInformationFile function's documentation for more information.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyReadFile Event (CBMonitor Component)

This event fires when data have been read from a file.

Syntax

// CBMonitorNotifyReadFileEventArgs carries the CBMonitor NotifyReadFile event's parameters.
type CBMonitorNotifyReadFileEventArgs struct {...}

func (args *CBMonitorNotifyReadFileEventArgs) FileName() string
func (args *CBMonitorNotifyReadFileEventArgs) Position() int64
func (args *CBMonitorNotifyReadFileEventArgs) BytesToRead() int32
func (args *CBMonitorNotifyReadFileEventArgs) Direction() int32
func (args *CBMonitorNotifyReadFileEventArgs) BytesRead() int32
func (args *CBMonitorNotifyReadFileEventArgs) Status() int32
func (args *CBMonitorNotifyReadFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyReadFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyReadFileEvent defines the signature of the CBMonitor NotifyReadFile event's handler function.
type CBMonitorNotifyReadFileEvent func(sender *CBMonitor, args *CBMonitorNotifyReadFileEventArgs)

func (obj *CBMonitor) GetOnNotifyReadFileHandler() CBMonitorNotifyReadFileEvent
func (obj *CBMonitor) SetOnNotifyReadFileHandler(handlerFunc CBMonitorNotifyReadFileEvent)

Remarks

This event fires when data have been read from a file specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_READ flag.

The Position parameter reflects the byte offset in the file at which reading started.

The BytesToRead parameter reflects how many bytes were to be read from the file.

The Direction parameter indicates the request direction; please refer to the Cached and Non-Cached Requests topic for more information. Possible values are as follows:

FS_REQUEST_DIR_USER_NONCACHED0Operations performed in the user mode application <--> filesystem direction.
FS_REQUEST_DIR_USER_CACHED1Operations performed in the user mode application <--> system cache direction.
FS_REQUEST_DIR_SYSTEM_NONCACHED2Operations performed in the system cache <--> filesystem direction.
FS_REQUEST_DIR_SYSTEM_CACHED3Operations performed in the system component <--> system cache direction.

The BytesRead parameter reflects how many bytes were actually read from the file.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyRenameOrMoveFile Event (CBMonitor Component)

This event fires when a file or directory has been renamed or moved.

Syntax

// CBMonitorNotifyRenameOrMoveFileEventArgs carries the CBMonitor NotifyRenameOrMoveFile event's parameters.
type CBMonitorNotifyRenameOrMoveFileEventArgs struct {...}

func (args *CBMonitorNotifyRenameOrMoveFileEventArgs) FileName() string
func (args *CBMonitorNotifyRenameOrMoveFileEventArgs) NewFileName() string
func (args *CBMonitorNotifyRenameOrMoveFileEventArgs) Status() int32
func (args *CBMonitorNotifyRenameOrMoveFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyRenameOrMoveFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyRenameOrMoveFileEvent defines the signature of the CBMonitor NotifyRenameOrMoveFile event's handler function.
type CBMonitorNotifyRenameOrMoveFileEvent func(sender *CBMonitor, args *CBMonitorNotifyRenameOrMoveFileEventArgs)

func (obj *CBMonitor) GetOnNotifyRenameOrMoveFileHandler() CBMonitorNotifyRenameOrMoveFileEvent
func (obj *CBMonitor) SetOnNotifyRenameOrMoveFileHandler(handlerFunc CBMonitorNotifyRenameOrMoveFileEvent)

Remarks

This event fires when a file or directory specified by FileName has been renamed or moved to NewFileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_RENAME flag. A rule's mask is matched against both previous and new file names, and the event will fire when either of the names matches the mask.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifySetAllocationSize Event (CBMonitor Component)

This event fires when a file's allocation size has been changed.

Syntax

// CBMonitorNotifySetAllocationSizeEventArgs carries the CBMonitor NotifySetAllocationSize event's parameters.
type CBMonitorNotifySetAllocationSizeEventArgs struct {...}

func (args *CBMonitorNotifySetAllocationSizeEventArgs) FileName() string
func (args *CBMonitorNotifySetAllocationSizeEventArgs) AllocationSize() int64
func (args *CBMonitorNotifySetAllocationSizeEventArgs) Status() int32
func (args *CBMonitorNotifySetAllocationSizeEventArgs) ResultCode() int32
func (args *CBMonitorNotifySetAllocationSizeEventArgs) SetResultCode(value int32)

// CBMonitorNotifySetAllocationSizeEvent defines the signature of the CBMonitor NotifySetAllocationSize event's handler function.
type CBMonitorNotifySetAllocationSizeEvent func(sender *CBMonitor, args *CBMonitorNotifySetAllocationSizeEventArgs)

func (obj *CBMonitor) GetOnNotifySetAllocationSizeHandler() CBMonitorNotifySetAllocationSizeEvent
func (obj *CBMonitor) SetOnNotifySetAllocationSizeHandler(handlerFunc CBMonitorNotifySetAllocationSizeEvent)

Remarks

This event fires when the allocation size of the file specified by FileName has been changed. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_SET_SIZES flag.

The AllocationSize parameter reflects the new allocation size, in bytes. A file's allocation size is typically larger than its actual size because filesystem operations often reserve space on disk before writing additional data to a file.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifySetEa Event (CBMonitor Component)

This event fires when information about the extended attributes of a file has been changed.

Syntax

// CBMonitorNotifySetEaEventArgs carries the CBMonitor NotifySetEa event's parameters.
type CBMonitorNotifySetEaEventArgs struct {...}

func (args *CBMonitorNotifySetEaEventArgs) FileName() string
func (args *CBMonitorNotifySetEaEventArgs) Buffer() []byte
func (args *CBMonitorNotifySetEaEventArgs) BufferLength() int32
func (args *CBMonitorNotifySetEaEventArgs) Status() int32
func (args *CBMonitorNotifySetEaEventArgs) ResultCode() int32
func (args *CBMonitorNotifySetEaEventArgs) SetResultCode(value int32)

// CBMonitorNotifySetEaEvent defines the signature of the CBMonitor NotifySetEa event's handler function.
type CBMonitorNotifySetEaEvent func(sender *CBMonitor, args *CBMonitorNotifySetEaEventArgs)

func (obj *CBMonitor) GetOnNotifySetEaHandler() CBMonitorNotifySetEaEvent
func (obj *CBMonitor) SetOnNotifySetEaHandler(handlerFunc CBMonitorNotifySetEaEvent)

Remarks

This event fires when information about the extended attributes of a file specified by FileName has been changed. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

If the file is created or opened with extended attributes passed in the request, this event will fire shortly after the NotifyCreateFile or NotifyOpenFile event.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_SET_EA flag.

The Buffer parameter points to a memory buffer that specifies the extended attribute information. The Length parameter reflects the length of this buffer, in bytes. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The data are formatted as a FILE_FULL_EA_INFORMATION structure; please refer to the Microsoft's documentation for more information.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifySetFileAttributes Event (CBMonitor Component)

This event fires when a file or directory's attributes or times have been changed.

Syntax

// CBMonitorNotifySetFileAttributesEventArgs carries the CBMonitor NotifySetFileAttributes event's parameters.
type CBMonitorNotifySetFileAttributesEventArgs struct {...}

func (args *CBMonitorNotifySetFileAttributesEventArgs) FileName() string
func (args *CBMonitorNotifySetFileAttributesEventArgs) CreationTime() time.Time
func (args *CBMonitorNotifySetFileAttributesEventArgs) LastAccessTime() time.Time
func (args *CBMonitorNotifySetFileAttributesEventArgs) LastWriteTime() time.Time
func (args *CBMonitorNotifySetFileAttributesEventArgs) ChangeTime() time.Time
func (args *CBMonitorNotifySetFileAttributesEventArgs) Attributes() int32
func (args *CBMonitorNotifySetFileAttributesEventArgs) Status() int32
func (args *CBMonitorNotifySetFileAttributesEventArgs) ResultCode() int32
func (args *CBMonitorNotifySetFileAttributesEventArgs) SetResultCode(value int32)

// CBMonitorNotifySetFileAttributesEvent defines the signature of the CBMonitor NotifySetFileAttributes event's handler function.
type CBMonitorNotifySetFileAttributesEvent func(sender *CBMonitor, args *CBMonitorNotifySetFileAttributesEventArgs)

func (obj *CBMonitor) GetOnNotifySetFileAttributesHandler() CBMonitorNotifySetFileAttributesEvent
func (obj *CBMonitor) SetOnNotifySetFileAttributesHandler(handlerFunc CBMonitorNotifySetFileAttributesEvent)

Remarks

This event fires when the attributes or times of the file or directory specified by FileName have been changed. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_SET_ATTRIBUTES flag.

The CreationTime, LastAccessTime, LastWriteTime, and ChangeTime parameters reflect the new time values, specified in UTC. A value of January 1, 1601 00:00:00 UTC indicates that the corresponding time value was not included in the request.

The Attributes parameter reflects the new attributes; please refer to Microsoft's File Attribute Constants article for attribute descriptions.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifySetFileInfo Event (CBMonitor Component)

This event fires when information about a file or directory has been changed.

Syntax

// CBMonitorNotifySetFileInfoEventArgs carries the CBMonitor NotifySetFileInfo event's parameters.
type CBMonitorNotifySetFileInfoEventArgs struct {...}

func (args *CBMonitorNotifySetFileInfoEventArgs) FileName() string
func (args *CBMonitorNotifySetFileInfoEventArgs) FileInformationClass() int32
func (args *CBMonitorNotifySetFileInfoEventArgs) Buffer() []byte
func (args *CBMonitorNotifySetFileInfoEventArgs) BufferLength() int32
func (args *CBMonitorNotifySetFileInfoEventArgs) ValidBytes() int32
func (args *CBMonitorNotifySetFileInfoEventArgs) Status() int32
func (args *CBMonitorNotifySetFileInfoEventArgs) ResultCode() int32
func (args *CBMonitorNotifySetFileInfoEventArgs) SetResultCode(value int32)

// CBMonitorNotifySetFileInfoEvent defines the signature of the CBMonitor NotifySetFileInfo event's handler function.
type CBMonitorNotifySetFileInfoEvent func(sender *CBMonitor, args *CBMonitorNotifySetFileInfoEventArgs)

func (obj *CBMonitor) GetOnNotifySetFileInfoHandler() CBMonitorNotifySetFileInfoEvent
func (obj *CBMonitor) SetOnNotifySetFileInfoHandler(handlerFunc CBMonitorNotifySetFileInfoEvent)

Remarks

This event fires when information about a file or directory specified by FileName has been changed. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic. This event typically fires in response to the Windows API's NtSetInformationFile function.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_QUERY_FILE_INFO flag.

The FileInformationClass parameter indicates what kind of file information was set. Please refer to the NtSetInformationFile function's documentation for more information about possible values.

The Buffer parameter points to a memory buffer that, if the request was successful, contains the new file information. The BufferLength and ValidBytes parameters reflect the capacity of Buffer and the length of the data it contains (respectively), in bytes; ValidBytes may be less than BufferLength. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The format of the data is determined by the specified FileInformationClass; please refer to the NtSetInformationFile function's documentation for more information.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifySetFileSecurity Event (CBMonitor Component)

This event fires when a file or directory's security attributes have been changed.

Syntax

// CBMonitorNotifySetFileSecurityEventArgs carries the CBMonitor NotifySetFileSecurity event's parameters.
type CBMonitorNotifySetFileSecurityEventArgs struct {...}

func (args *CBMonitorNotifySetFileSecurityEventArgs) FileName() string
func (args *CBMonitorNotifySetFileSecurityEventArgs) SecurityInformation() int32
func (args *CBMonitorNotifySetFileSecurityEventArgs) SecurityDescriptor() []byte
func (args *CBMonitorNotifySetFileSecurityEventArgs) Length() int32
func (args *CBMonitorNotifySetFileSecurityEventArgs) Status() int32
func (args *CBMonitorNotifySetFileSecurityEventArgs) ResultCode() int32
func (args *CBMonitorNotifySetFileSecurityEventArgs) SetResultCode(value int32)

// CBMonitorNotifySetFileSecurityEvent defines the signature of the CBMonitor NotifySetFileSecurity event's handler function.
type CBMonitorNotifySetFileSecurityEvent func(sender *CBMonitor, args *CBMonitorNotifySetFileSecurityEventArgs)

func (obj *CBMonitor) GetOnNotifySetFileSecurityHandler() CBMonitorNotifySetFileSecurityEvent
func (obj *CBMonitor) SetOnNotifySetFileSecurityHandler(handlerFunc CBMonitorNotifySetFileSecurityEvent)

Remarks

This event fires when security attributes have been changed for a file or directory specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_SET_SECURITY flag.

The SecurityInformation parameter reflects which pieces of security information, of those present in SecurityDescriptor, were to be set. Please refer to Microsoft's SECURITY_INFORMATION data-type documentation for more information about possible values.

The SecurityDescriptor parameter points to a memory buffer that contains the new security information. The Length parameter reflects the length of this data, in bytes. Please see the Buffer Parameters topic for more information on how to work with memory buffer event parameters.

The data are formatted as a SECURITY_DESCRIPTOR structure in self-relative format; please refer to the Microsoft's documentation for more information.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifySetFileSize Event (CBMonitor Component)

This event fires when a file has been resized.

Syntax

// CBMonitorNotifySetFileSizeEventArgs carries the CBMonitor NotifySetFileSize event's parameters.
type CBMonitorNotifySetFileSizeEventArgs struct {...}

func (args *CBMonitorNotifySetFileSizeEventArgs) FileName() string
func (args *CBMonitorNotifySetFileSizeEventArgs) Size() int64
func (args *CBMonitorNotifySetFileSizeEventArgs) Status() int32
func (args *CBMonitorNotifySetFileSizeEventArgs) ResultCode() int32
func (args *CBMonitorNotifySetFileSizeEventArgs) SetResultCode(value int32)

// CBMonitorNotifySetFileSizeEvent defines the signature of the CBMonitor NotifySetFileSize event's handler function.
type CBMonitorNotifySetFileSizeEvent func(sender *CBMonitor, args *CBMonitorNotifySetFileSizeEventArgs)

func (obj *CBMonitor) GetOnNotifySetFileSizeHandler() CBMonitorNotifySetFileSizeEvent
func (obj *CBMonitor) SetOnNotifySetFileSizeHandler(handlerFunc CBMonitorNotifySetFileSizeEvent)

Remarks

This event fires when the file specified by FileName has been resized, whether explicitly (e.g., truncation) or implicitly (i.e., as data are appended). For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_SET_SIZES flag.

The Size parameter reflects the new file size, in bytes.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifySetReparsePoint Event (CBMonitor Component)

This event fires when a file or directory's reparse point has been created or updated.

Syntax

// CBMonitorNotifySetReparsePointEventArgs carries the CBMonitor NotifySetReparsePoint event's parameters.
type CBMonitorNotifySetReparsePointEventArgs struct {...}

func (args *CBMonitorNotifySetReparsePointEventArgs) FileName() string
func (args *CBMonitorNotifySetReparsePointEventArgs) ReparseTag() int64
func (args *CBMonitorNotifySetReparsePointEventArgs) Status() int32
func (args *CBMonitorNotifySetReparsePointEventArgs) ResultCode() int32
func (args *CBMonitorNotifySetReparsePointEventArgs) SetResultCode(value int32)

// CBMonitorNotifySetReparsePointEvent defines the signature of the CBMonitor NotifySetReparsePoint event's handler function.
type CBMonitorNotifySetReparsePointEvent func(sender *CBMonitor, args *CBMonitorNotifySetReparsePointEventArgs)

func (obj *CBMonitor) GetOnNotifySetReparsePointHandler() CBMonitorNotifySetReparsePointEvent
func (obj *CBMonitor) SetOnNotifySetReparsePointHandler(handlerFunc CBMonitorNotifySetReparsePointEvent)

Remarks

This event fires when a reparse point has been created or updated for a file or directory specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_SET_REPARSE_POINT flag.

The ReparseTag parameter contains the reparse tag, which is the value the system uses to identify the format of the reparse point data.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyUnlockAll Event (CBMonitor Component)

This event fires when all locked byte ranges in a file have been unlocked.

Syntax

// CBMonitorNotifyUnlockAllEventArgs carries the CBMonitor NotifyUnlockAll event's parameters.
type CBMonitorNotifyUnlockAllEventArgs struct {...}

func (args *CBMonitorNotifyUnlockAllEventArgs) FileName() string
func (args *CBMonitorNotifyUnlockAllEventArgs) Status() int32
func (args *CBMonitorNotifyUnlockAllEventArgs) ResultCode() int32
func (args *CBMonitorNotifyUnlockAllEventArgs) SetResultCode(value int32)

// CBMonitorNotifyUnlockAllEvent defines the signature of the CBMonitor NotifyUnlockAll event's handler function.
type CBMonitorNotifyUnlockAllEvent func(sender *CBMonitor, args *CBMonitorNotifyUnlockAllEventArgs)

func (obj *CBMonitor) GetOnNotifyUnlockAllHandler() CBMonitorNotifyUnlockAllEvent
func (obj *CBMonitor) SetOnNotifyUnlockAllHandler(handlerFunc CBMonitorNotifyUnlockAllEvent)

Remarks

This event fires when all locked byte ranges in the file specified by FileName have been unlocked. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_LOCK_CONTROL flag.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyUnlockAllByKey Event (CBMonitor Component)

This event fires when all locked byte ranges in a file, associated with a particular key, have been unlocked.

Syntax

// CBMonitorNotifyUnlockAllByKeyEventArgs carries the CBMonitor NotifyUnlockAllByKey event's parameters.
type CBMonitorNotifyUnlockAllByKeyEventArgs struct {...}

func (args *CBMonitorNotifyUnlockAllByKeyEventArgs) FileName() string
func (args *CBMonitorNotifyUnlockAllByKeyEventArgs) Key() int64
func (args *CBMonitorNotifyUnlockAllByKeyEventArgs) Status() int32
func (args *CBMonitorNotifyUnlockAllByKeyEventArgs) ResultCode() int32
func (args *CBMonitorNotifyUnlockAllByKeyEventArgs) SetResultCode(value int32)

// CBMonitorNotifyUnlockAllByKeyEvent defines the signature of the CBMonitor NotifyUnlockAllByKey event's handler function.
type CBMonitorNotifyUnlockAllByKeyEvent func(sender *CBMonitor, args *CBMonitorNotifyUnlockAllByKeyEventArgs)

func (obj *CBMonitor) GetOnNotifyUnlockAllByKeyHandler() CBMonitorNotifyUnlockAllByKeyEvent
func (obj *CBMonitor) SetOnNotifyUnlockAllByKeyHandler(handlerFunc CBMonitorNotifyUnlockAllByKeyEvent)

Remarks

This event fires when all locked byte ranges in the file specified by FileName, and associated with the specified Key, have been unlocked. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_LOCK_CONTROL flag.

The Key parameter contains the key value specified when the byte ranges were locked. Please refer to the NotifyLock event's documentation for more information.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyUnlockSingle Event (CBMonitor Component)

This event fires when a particular locked byte range in a file has been unlocked.

Syntax

// CBMonitorNotifyUnlockSingleEventArgs carries the CBMonitor NotifyUnlockSingle event's parameters.
type CBMonitorNotifyUnlockSingleEventArgs struct {...}

func (args *CBMonitorNotifyUnlockSingleEventArgs) FileName() string
func (args *CBMonitorNotifyUnlockSingleEventArgs) Offset() int64
func (args *CBMonitorNotifyUnlockSingleEventArgs) Length() int64
func (args *CBMonitorNotifyUnlockSingleEventArgs) Key() int64
func (args *CBMonitorNotifyUnlockSingleEventArgs) Status() int32
func (args *CBMonitorNotifyUnlockSingleEventArgs) ResultCode() int32
func (args *CBMonitorNotifyUnlockSingleEventArgs) SetResultCode(value int32)

// CBMonitorNotifyUnlockSingleEvent defines the signature of the CBMonitor NotifyUnlockSingle event's handler function.
type CBMonitorNotifyUnlockSingleEvent func(sender *CBMonitor, args *CBMonitorNotifyUnlockSingleEventArgs)

func (obj *CBMonitor) GetOnNotifyUnlockSingleHandler() CBMonitorNotifyUnlockSingleEvent
func (obj *CBMonitor) SetOnNotifyUnlockSingleHandler(handlerFunc CBMonitorNotifyUnlockSingleEvent)

Remarks

This event fires when a particular locked byte range in a file specified by FileName has been unlocked. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_LOCK_CONTROL flag.

The Offset, Length, and Key parameters contain the starting byte offset, length, and key values, respectively, specified when the byte range was locked. Please refer to the NotifyLock event's documentation for more information.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

NotifyWriteFile Event (CBMonitor Component)

This event fires when data have been written to a file.

Syntax

// CBMonitorNotifyWriteFileEventArgs carries the CBMonitor NotifyWriteFile event's parameters.
type CBMonitorNotifyWriteFileEventArgs struct {...}

func (args *CBMonitorNotifyWriteFileEventArgs) FileName() string
func (args *CBMonitorNotifyWriteFileEventArgs) Position() int64
func (args *CBMonitorNotifyWriteFileEventArgs) BytesToWrite() int32
func (args *CBMonitorNotifyWriteFileEventArgs) Direction() int32
func (args *CBMonitorNotifyWriteFileEventArgs) BytesWritten() int32
func (args *CBMonitorNotifyWriteFileEventArgs) Status() int32
func (args *CBMonitorNotifyWriteFileEventArgs) ResultCode() int32
func (args *CBMonitorNotifyWriteFileEventArgs) SetResultCode(value int32)

// CBMonitorNotifyWriteFileEvent defines the signature of the CBMonitor NotifyWriteFile event's handler function.
type CBMonitorNotifyWriteFileEvent func(sender *CBMonitor, args *CBMonitorNotifyWriteFileEventArgs)

func (obj *CBMonitor) GetOnNotifyWriteFileHandler() CBMonitorNotifyWriteFileEvent
func (obj *CBMonitor) SetOnNotifyWriteFileHandler(handlerFunc CBMonitorNotifyWriteFileEvent)

Remarks

This event fires when data have been written to the file specified by FileName. For more information about the FileName parameter and what it may contain, please refer to the Filenames In Events topic.

Applications need to handle this event only if they have added a standard filter rule that includes the FS_NE_WRITE flag.

The Position parameter reflects the byte offset in the file at which writing started. A value of -1 means "append to the end of the file".

The BytesToWrite parameter reflects how many bytes were to be written to the file.

The Direction parameter indicates the request direction; please refer to the Cached and Non-Cached Requests topic for more information. Possible values are as follows:

FS_REQUEST_DIR_USER_NONCACHED0Operations performed in the user mode application <--> filesystem direction.
FS_REQUEST_DIR_USER_CACHED1Operations performed in the user mode application <--> system cache direction.
FS_REQUEST_DIR_SYSTEM_NONCACHED2Operations performed in the system cache <--> filesystem direction.
FS_REQUEST_DIR_SYSTEM_CACHED3Operations performed in the system component <--> system cache direction.

The BytesWritten parameter reflects how many bytes were actually written to the file.

The Status parameter contains an NT status code that indicates the outcome of the operation; 0 indicates success. To convert this value to a Win32 error code, call the NtStatusToWin32Error method.

Note: This event will not fire for failed requests unless the ProcessFailedRequests property is enabled.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason, set it to a non-zero value to report an appropriate error.

Note: This event fires after the operation has already completed, so reporting an error will not actually affect the operation itself. Please refer to the Error Handling topic for more information.

This event is fired asynchronously; please refer to the Event Types topic for more information.

WorkerThreadCreation Event (CBMonitor Component)

Fires just after a new worker thread is created.

Syntax

// CBMonitorWorkerThreadCreationEventArgs carries the CBMonitor WorkerThreadCreation event's parameters.
type CBMonitorWorkerThreadCreationEventArgs struct {...}

func (args *CBMonitorWorkerThreadCreationEventArgs) ResultCode() int32
func (args *CBMonitorWorkerThreadCreationEventArgs) SetResultCode(value int32)

// CBMonitorWorkerThreadCreationEvent defines the signature of the CBMonitor WorkerThreadCreation event's handler function.
type CBMonitorWorkerThreadCreationEvent func(sender *CBMonitor, args *CBMonitorWorkerThreadCreationEventArgs)

func (obj *CBMonitor) GetOnWorkerThreadCreationHandler() CBMonitorWorkerThreadCreationEvent
func (obj *CBMonitor) SetOnWorkerThreadCreationHandler(handlerFunc CBMonitorWorkerThreadCreationEvent)

Remarks

This event fires just after a worker thread is created, in the context of that worker thread.

This event is optional; it is provided to give applications a chance to perform additional processing when a new worker thread is created, such as allocating per-thread objects.

The struct maintains a pool of worker threads and uses them to fire events; please refer to the Threading and Concurrency topic for more information.

The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource is not available or security checks failed), set it to a nonzero value to report an appropriate error. Please see the Error Handling topic for more information.

This event is fired synchronously; please refer to the Event Types topic for more information.

WorkerThreadTermination Event (CBMonitor Component)

Fires just before a worker thread is terminated.

Syntax

// CBMonitorWorkerThreadTerminationEventArgs carries the CBMonitor WorkerThreadTermination event's parameters.
type CBMonitorWorkerThreadTerminationEventArgs struct {...}

// CBMonitorWorkerThreadTerminationEvent defines the signature of the CBMonitor WorkerThreadTermination event's handler function.
type CBMonitorWorkerThreadTerminationEvent func(sender *CBMonitor, args *CBMonitorWorkerThreadTerminationEventArgs)

func (obj *CBMonitor) GetOnWorkerThreadTerminationHandler() CBMonitorWorkerThreadTerminationEvent
func (obj *CBMonitor) SetOnWorkerThreadTerminationHandler(handlerFunc CBMonitorWorkerThreadTerminationEvent)

Remarks

This event fires just before a worker thread is terminated, in the context of that worker thread.

This event is optional; it is provided to give applications a chance to perform additional processing before a worker thread is terminated, such as deallocating per-thread objects.

The struct maintains a pool of worker threads and uses them to fire events; please refer to the Threading and Concurrency topic for more information.

Any errors that occur during this event are ignored.

This event is fired synchronously; please refer to the Event Types topic for more information.

Config Settings (CBMonitor Component)

The struct accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the struct, access to these internal properties is provided through the Config method.

CBMonitor Config Settings

AlwaysPrepareFiles:   Whether the driver should keep track of information for files that are already open when (i.e., were opened before) the struct is initialized.

This setting corresponds to the INSTALL_ALWAYS_PREPARE_FILES flag, which is used with the Install method. Please refer to the documentation for both for more information. If this setting is enabled when Install is called, the aforementioned flag will be set automatically.

Administrative rights are required to change this configuration setting after Initialize is called. If the user account of the process that calls Config does not have such rights, the call will fail with an ERROR_PRIVILEGE_NOT_HELD (0x0522) error.

AlwaysRequestAttributesOnOpen:   Whether the driver should keep request existing attributes before file create/open operation.

Normally, the driver requests existing attributes of the file or directory that is created or opened only when extended rules are set. This setting is disabled by default.

Enable this setting to tell the driver to always request the existing attributes and pass them to the ExistingAttributes parameter of the events, as related to file creation and opening.

CollectRemoteOpenInformation:   Enables collection of information about remote filesystem requests.

This information includes an address of the client and the name of the share through which the access was made.

By default, this configuration setting is disabled. Enable it to use the GetRemoteAccessInformation method.

FilterOwnRequests:   Whether the struct's system driver should filter requests made by the application itself.

This configuration setting specifies whether requests made by the application should be filtered through the struct's system driver (assuming that they match one of the rules present at the time). When this setting is disabled (default), and the application performs some operation that would match an existing rule, the driver will explicitly ignore it.

Normally, this setting should remain disabled (especially in production) to reduce the possibility of system deadlocks occurring. Certain situations, however, do require it to be enabled, such as for testing purposes (so that event handlers can be tested with single-process tests).

ForceAppPermissionCheck:   Whether the driver should require the controller process to have elevated or system privileges.

This configuration setting corresponds to the INSTALL_FORCE_APP_PERMISSION_CHECK flag, which is used with the Install method; please refer to the documentation for both for more information. If this setting is enabled when Install is called, the aforementioned flag will be set automatically.

Administrative rights are required to change this configuration setting after Initialize is called. If the user account of the process that calls Config does not have such rights, the call will fail with an ERROR_PRIVILEGE_NOT_HELD (0x0522) error.

ForceSecurityChecks:   Whether the driver should prevent the controller process from filtering files that it would not normally have access to.

This configuration setting corresponds to the INSTALL_FORCE_SECURITY_CHECKS flag, which is used with the Install method; please refer to the documentation for both for more information. If this setting is enabled when Install is called, the aforementioned flag will be set automatically.

Administrative rights are required to change this configuration setting after Initialize is called. If the user account of the process that calls Config does not have such rights, the call will fail with an ERROR_PRIVILEGE_NOT_HELD (0x0522) error.

LoggingEnabled:   Whether extended logging is enabled.

This setting specifies whether extended logging is enabled for this struct; it is disabled by default. Please refer to the Error Handling topic for more information.

This setting's value is stored in the registry and is persistent; it requires administrative rights to be changed.

MaxWorkerThreadCount:   The maximum number of worker threads to use to fire events.

This setting specifies the maximum number of worker threads the struct may create to fire events on when the SerializeEvents property is set to seOnMultipleThreads. (If other cases, this setting does not apply.)

By default, this setting is set to 0, and the driver automatically chooses an optimal number of threads using this equation: 4 * number_of_processors.

MinWorkerThreadCount:   The minimum number of worker threads to use to fire events.

This setting specifies the minimum number of worker threads the struct should create to fire events on when the SerializeEvents property is set to seOnMultipleThreads. (In other cases, this setting does not apply.)

By default, this setting is set to 0, and the driver automatically chooses an optimal number of threads using this equation: max(number_of_processors, 4). If this setting's value exceeds the MaxWorkerThreadCount value, the latter is used instead.

NormalizeShortFileNames:   Whether the driver should attempt to resolve short file names and convert them to regular ones.

This configuration setting specifies how the driver should handle short file names in paths that it deals with. The possible values are

  • 0 - Never: Do nothing in regard to the short file names.
  • 1 - on local file systems: Causes the driver to attempt to resolve short file names, but only for local filesystems.
  • 2 - always: Causes the driver to attempt to resolve short file names for files on all filesystems.
OmitEventFileNames:   Whether the filename parameter should be empty in events.

In some editions of the product, passing an extra string parameter to events involves extra allocation of memory and is an unnecessary expenditure of CPU cycles. Enabling this setting makes the component skip passing the file name to event handlers. Event handlers can obtain the file or directory name by calling the GetEventFileName method.

By default this setting is disabled.

Note: This setting cannot be changed when Active is true, and it cannot be changed within events.

PassAllFileNames:   Whether the driver should pass all known names of a file, including hardlinks and previous names, to event handlers.

While the filter is active, it keeps track of file operations that change the set of names of a file or directory. This includes renaming, deletion, and hardlink creation operations.

When this configuration setting is enabled, all known names (both current and old) are passed to event handlers as described in the Filenames In Events topic. By default, this setting is disabled.

PassSecurityInFileOpenEvents:   Whether security information, associated with the file create/open request, is passed to file creation and opening events.

This setting specifies whether the security descriptor, passed by the originator of file creation or opening request to the CreateFile() or similar Windows API function, should be passed to various *FileCreate/*FileOpen events. This setting is disabled by default for performance reasons.

Note: This setting cannot be changed within events.

PreprocessedRulesCacheSize:   Maximum number of preprocessed rules to keep cached.

This configuration setting specifies the maximum number of preprocessed rules that the struct's system driver should keep cached; it is set to 1024 by default.

When a file or directory is first opened, the struct's system driver determines which of the currently active rules it matches, if any. The results of this process are collected into a single preprocessed rule internally, which is then cached. These preprocessed rules can provide significant performance improvements, especially if many rules have been added, because they prevent the driver from having to recheck each rule every time an operation occurs.

RecordOperationTime:   Enables collection of operation time.

By default, this configuration setting is disabled and the driver does not record the time of each operation. If the application needs to use the GetOperationTime method, it must enable this setting.

ResolveNtDeviceToDriveLetter:   Whether native device names are translated to drive letters.

This configuration setting specifies whether NT native device names, like \Device\HarddiskVolume1\..., should be translated to DOS-style drive letters, like C:\... when possible. However, please note the following:

  • Such translation will be performed only if a device actually has a corresponding DOS-style drive letter; not all devices do.
  • The BeforeFilterAttachToVolume event always uses NT native device names, because DOS-style drive letters are not assigned until after it fires.

This setting is enabled by default; it can be disabled to improve performance, or if the application needs the native device name.

Note: This setting cannot be changed when Active is true, and it cannot be changed within events.

RetriveLinkNamesOnOpen:   Specifies that the driver should collect all hard links when a file is opened.

If an application performs some protection functions on a per-directory basis and hard links may help a user circumvent such a protection, this setting may be used to collect all names of a file or directory (hard links to it) so that all of the names are matched against the rules.

If an application performs path analysis in event handlers, it needs to enable the PassAllFileNames setting as well in order to receive all collected names.

The setting is disabled by default for performance reasons.

Note: hard links are supported only on some filesystems, but are enabled by default in regular NTFS.

SendRequestsViaDriverStack:   Whether internal requests to the filesystem are sent directly to the filesystem driver or through the stack of filesystem filter drivers.

This configuration setting corresponds to the INSTALL_REQUESTS_VIA_DRIVER_STACK flag, which is used with the Install method; please refer to the documentation for more information. If this setting is enabled when Install is called, the aforementioned flag will be set automatically.

Administrative rights are required to change this configuration setting after Initialize is called. If the user account of the process that calls Config does not have such rights, the call will fail with an ERROR_PRIVILEGE_NOT_HELD (0x0522) error.

WorkerInitialStackSize:   The initial stack size to create worker threads with.

This setting specifies the initial size of the stack each worker thread is created with. The system rounds this value to the nearest page.

By default, this setting is set to 0, and the driver uses a default stack size (currently, 1 MB).

Note: This setting cannot be changed when Active is true, and it cannot be changed within events.

Base Config Settings

BuildInfo:   Information about the product's build.

When queried, this setting will return a string containing information about the product's build.

LicenseInfo:   Information about the current license.

When queried, this setting will return a string containing information about the license this instance of a struct is using. It will return the following information:

  • Product: The product the license is for.
  • Product Key: The key the license was generated from.
  • License Source: Where the license was found (e.g., RuntimeLicense, License File).
  • License Type: The type of license installed (e.g., Royalty Free, Single Server).

Trappable Errors (CBMonitor Component)

The struct uses Windows error codes during operation as necessary. Please refer to the Error Handling topic for more information.

Special Use Errors

21   ERROR_NOT_READY: Reported by the methods of the struct if Initialize has not been called or did not succeed.
191   ERROR_INVALID_EXE_SIGNATURE: Reported by the Install method when the CAB file signature cannot be validated.
575   ERROR_APP_INIT_FAILURE: Reported by the methods of the struct if Initialize has not been called or did not succeed. Differs from ERROR_NOT_READY (21) in that it indicates a specific situation in the internal code.
588   ERROR_FS_DRIVER_REQUIRED: Reported if the required system module was not correctly installed for the given ProductGUID.
614   ERROR_NO_CALLBACK_ACTIVE: Reported by any method that can only be called within event handlers if it is called outside an event handler.
1292   ERROR_IMPLEMENTATION_LIMIT: Reported when the timeout value provided is less than 3 seconds.
1314   ERROR_PRIVILEGE_NOT_HELD: Reported by any method that requires elevated permissions if it is called without such permissions.