FSCTL_QUERY_USN_JOURNAL IOCTL (winioctl.h)

Queries for information on the current update sequence number (USN) change journal, its records, and its capacity.

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       Device,          // handle to volume
                 (DWORD) FSCTL_QUERY_USN_JOURNAL,// dwIoControlCode
                 (LPVOID)       NULL,            // lpInBuffer
                 (DWORD)        0,               // nInBufferSize
                 (LPVOID)       lpOutBuffer,     // output buffer
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Remarks

For the implications of overlapped I/O on this operation, see the Remarks section of the DeviceIoControl topic.

For more information, see Creating, Modifying, and Deleting a Change Journal.

To retrieve a handle to a volume, call CreateFile with the lpFileName parameter set to a string in the following form:

\\.\X:

In the preceding string, X is the letter identifying the drive on which the volume appears. The volume must be formatted with the NTFS filesystem.

In Windows 8 and Windows Server 2012, this code is supported by the following technologies.

An application may experience false positives on CsvFs pause/resume.

Requirements

See also

Change Journals

CreateFile

DeviceIoControl

GetOverlappedResult

GetQueuedCompletionStatus

OVERLAPPED

USN_JOURNAL_DATA_V0

USN_JOURNAL_DATA_V1

USN_JOURNAL_DATA_V2

Volume Management Control Codes