FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

Artikel
06/27/2024

Ruft den Satz von USN-Änderungsjournaldatensätzen (Update Sequence Number, 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

Bemerkungen

Die Auswirkungen überlappender E/A für diesen Vorgang finden Sie im Abschnitt "Hinweise" des Themas DeviceIoControl.

Es gibt zwei DeviceIoControl- Steuerelementcodes, die USN-Datensätze, FSCTL_READ_USN_JOURNAL und FSCTL_ENUM_USN_DATAzurückgeben. Verwenden Sie letzteres, wenn Sie eine Auflistung (Aufzählung) der USN-Einträge zwischen zwei USNs wünschen. Verwenden Sie die erste Option, wenn Sie von USN auswählen möchten.

Weitere Informationen finden Sie unter Erstellen, Ändern und Löschen eines Änderungsjournals.

Rufen Sie zum Abrufen eines Handles zu einem Volume CreateFile- auf, wobei der parameter lpFileName auf eine Zeichenfolge in der folgenden Form festgelegt ist:

\\.\X-:

In der vorherigen Zeichenfolge ist X- der Buchstabe, der das Laufwerk angibt, 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	Abgestützt
Server Message Block (SMB) 3.0-Protokoll	Nein
SMB 3.0 Transparent Failover (TFO)	Nein
SMB 3.0 mit Skalierungsdateifreigaben (SO)	Nein
Freigegebenes Clustervolumedateisystem (CsvFS)	Kommentar anzeigen

Eine Anwendung kann falsch positive Ergebnisse auf CSVFs anhalten/fortsetzen.

Beispiele

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	winioctl.h (enthalten Windows.h)