FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

Artikel
03/04/2024

Ruft den Satz von Änderungsjournaldatensätzen für die Updatesequenznummer (USN) zwischen zwei angegebenen USN-Werten ab.

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode (LPVOID) lpInBuffer, // input buffer (DWORD) nInBufferSize, // size of input buffer (LPVOID) lpOutBuffer, // output buffer (DWORD) nOutBufferSize, // size of output buffer (LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

C++

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

Hinweise

Die Auswirkungen von überlappenden E/A-Vorgängen auf diesen Vorgang finden Sie im Abschnitt Hinweise des Themas DeviceIoControl .

Es gibt zwei DeviceIoControl-Steuerelementcodes , die USN-Datensätze zurückgeben, FSCTL_READ_USN_JOURNAL und FSCTL_ENUM_USN_DATA. Verwenden Sie letzteres, wenn Sie eine Auflistung (Enumeration) der USN-Einträge zwischen zwei USNs wünschen. Verwenden Sie ersteres, wenn Sie nach USN auswählen möchten.

Weitere Informationen finden Sie unter Erstellen, Ändern und Löschen einer Änderung Journal.

Um ein Handle für ein Volume abzurufen, rufen Sie CreateFile auf, wobei der lpFileName-Parameter auf eine Zeichenfolge in der folgenden Form festgelegt ist:

\.\X:

In der vorherigen Zeichenfolge ist X der Buchstabe, der das Laufwerk identifiziert, auf dem das Volume angezeigt wird. Das Volume muss NTFS sein.

In Windows 8 und Windows Server 2012 wird dieser Code von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Siehe Kommentar

Bei einer Anwendung kann es zu falsch positiven Ergebnissen bei CsvFs zum Anhalten/Fortsetzen von CsvFs gehen.

Beispiele

Ein Beispiel finden Sie unter Walking a Buffer of Change Journal Records.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)