Bewerken

Delen via


READ_USN_JOURNAL_DATA_V1 structure (ntifs.h)

The READ_USN_JOURNAL_DATA_V1 structure contains information defining a set of update sequence number (USN) change journal records to return to the calling process. It is used by the FSCTL_QUERY_USN_JOURNAL and FSCTL_READ_USN_JOURNAL control codes. Prior to Windows 8 and Windows Server 2012 this structure was named READ_USN_JOURNAL_DATA. Windows Server 2012 introduced READ_USN_JOURNAL_DATA_V1 to support 128-bit file identifiers used by ReFS.

Syntax

typedef struct {
  USN       StartUsn;
  ULONG     ReasonMask;
  ULONG     ReturnOnlyOnClose;
  ULONGLONG Timeout;
  ULONGLONG BytesToWaitFor;
  ULONGLONG UsnJournalID;
  USHORT    MinMajorVersion;
  USHORT    MaxMajorVersion;
} READ_USN_JOURNAL_DATA_V1, *PREAD_USN_JOURNAL_DATA_V1;

Members

StartUsn

See READ_USN_JOURNAL_DATA_V0.StartUsn.

ReasonMask

See READ_USN_JOURNAL_DATA_V0.ReasonMask.

ReturnOnlyOnClose

See READ_USN_JOURNAL_DATA_V0.ReturnOnlyOnClose.

Timeout

See READ_USN_JOURNAL_DATA_V0.Timeout.

BytesToWaitFor

See READ_USN_JOURNAL_DATA_V0.BytesToWaitFor.

UsnJournalID

See READ_USN_JOURNAL_DATA_V0.UsnJournalID.

MinMajorVersion

The minimum major version of the USN record that the caller can accept. This allows the caller to ensure compatibility with the journal format.

MaxMajorVersion

The maximum major version of the USN record that the caller can accept. This ensures that the caller does not receive records in an unexpected format.

Requirements

Requirement Value
Minimum supported client Windows 8
Header ntifs.h

See also

FSCTL_QUERY_USN_JOURNAL

FSCTL_READ_USN_JOURNAL