FSCTL_MARK_HANDLE IOCTL (ntifs.h)

The FSCTL_MARK_HANDLE control code marks a specified file or directory and its change journal record with information about changes to that file or directory.

Major code

FSCTL_MARK_HANDLE

Input buffer

Pointer to a MARK_HANDLE_INFO structure containing the information to use to mark a specified file or directory, and its update sequence number (USN) change journal record with data about changes.

Input buffer length

Size of the MARK_HANDLE_INFO structure that InputBuffer points to, in bytes.

Output buffer

Set to NULL.

Output buffer length

n/a (ignored)

Input / Output buffer

n/a

Input / Output buffer length

n/a

Status block

Reserved for system use.

Remarks

To perform this operation, call FltFsControlFile or ZwFsControlFile with the following parameters.

Parameter Description
Instance [in] For FltFsControlFile only. An opaque instance pointer for the caller. This parameter is required and cannot be NULL.
FileObject [in] For FltFsControlFile only. A file object pointer for the file or directory that is the target of this request. This parameter is required and cannot be NULL.
FileHandle [in] For ZwFsControlFile only. File handle of the file or directory that is the target of this request. This parameter is required and cannot be NULL.
FsControlCode [in] Set to FSCTL_MARK_HANDLE.
InputBuffer [in] Pointer to a MARK_HANDLE_INFO structure containing the information to use to mark a specified file or directory, and its update sequence number (USN) change journal record with data about changes.
InputBufferLength [in] Size of the buffer that InputBuffer points to, in bytes.
OutputBuffer [out] Set to NULL for this FSCTL.
OutputBufferLength [in] Ignored when OutputBuffer is NULL.
LengthReturned [out] Set to NULL.

Requirements

Requirement Value
Minimum supported client Windows XP
Header ntifs.h

See also

FltFsControlFile

ZwFsControlFile