Edit

Share via

FSCTL_QUERY_USN_JOURNAL IOCTL (ntifs.h)

  • Article

The FSCTL_QUERY_USN_JOURNAL control code queries for information on the current update sequence number (USN) change journal, its records, and its capacity. See Remarks.

Major code

FSCTL_QUERY_USN_JOURNAL

Remarks

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

  • FileObject [in]: Parameter for FltFsControlFile only. A file object pointer for the remote volume. This parameter is required and can't be NULL.

  • FileHandle [in]: Parameter for ZwFsControlFile only. A handle for the remote volume. This parameter is required and can't be NULL.

  • FsControlCode [in]: A control code for the operation. Use FSCTL_QUERY_USN_JOURNAL for this operation.

  • InputBuffer [in]: Not used.

  • InputBufferLength [in]: Not used.

  • OutputBuffer [out]: Pointer to a USN_JOURNAL_DATA structure that receives the information about the change journal.

  • OutputBufferLength [in]: Size in bytes of the buffer at OutputBuffer.

FltFsControlFile or ZwFsControlFile returns STATUS_SUCCESS if the operation succeeds. Otherwise, the appropriate function returns the appropriate NTSTATUS error code.

Requirements

Requirement Value
Minimum supported client Windows XP
Header ntifs.h

See also

USN_JOURNAL_DATA_V0

USN_JOURNAL_DATA_V1

USN_JOURNAL_DATA_V2