FSCTL_MARK_HANDLE IOCTL (ntifs.h)

Article
10/09/2023

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

Share via