FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Artikel

Ruft Informationen zum Änderungsjournal der Updatesequenznummer (USN) für die angegebene Datei oder das angegebene Verzeichnis ab.

Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                 (DWORD) FSCTL_READ_FILE_USN_DATA, // 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

Wenn der Aufruf erfolgreich ist, sind die Member der zurückgegebenen USN_RECORD_V2 - oder USN_RECORD_V3-Struktur gültig, mit Ausnahme der folgenden Member: TimeStamp, Reason und SourceInfo. Das Usn-Element stellt den letzten USN dar, der in das Journal für diese Datei oder dieses Verzeichnis geschrieben wurde.

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 ReFS oder NTFS 3.0 oder höher sein. Um die NTFS-Version eines Volumes abzurufen, öffnen Sie eine Eingabeaufforderung mit Administratorzugriffsrechten, und führen Sie den folgenden Befehl aus:

FSUtil.exe FSInfo NTFSInfo X:

Dabei entspricht X dem Laufwerkbuchstaben des Volumes.

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

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)

Weitere Informationen

CreateFile

DeviceIoControl

USN_RECORD

Volumeverwaltungs-Steuerungscodes