FSCTL_QUERY_USN_JOURNAL IOCTL (winioctl.h)

Artikel
03/13/2024

Fragt Informationen zum Änderungsjournal der aktuellen Updatesequenznummer (USN), seinen Datensätzen und seiner Kapazität ab.

C++
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

C++

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

Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl-Funktion mit den folgenden Parametern auf.

Hinweise

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

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

Um ein Handle für ein Volume abzurufen, rufen Sie CreateFile auf, wobei der parameter lpFileName auf eine Zeichenfolge im folgenden Format festgelegt ist:

\.\X:

In der vorherigen Zeichenfolge ist X der Buchstabe, der das Laufwerk identifiziert, auf dem das Volume angezeigt wird. Das Volume muss mit dem NTFS-Dateisystem formatiert 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)	Ja

Bei einer Anwendung treten möglicherweise falsch positive Ergebnisse für csvFs pause/resume auf.

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 (windows.h einschließen)