FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)

Artikel
08/27/2023

Generiert einen Datensatz im Änderungsjournalstream der Updatesequenznummer (USN) für die Eingabedatei. Dieser Datensatz weist das Flag "USN_REASON_CLOSE " auf.

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

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume FSCTL_WRITE_USN_CLOSE_RECORD, // dwIoControlCodeNULL, // lpInBuffer0, // 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) hDevice,              // handle to volume
                 FSCTL_WRITE_USN_CLOSE_RECORD,  // dwIoControlCodeNULL,                          // lpInBuffer0,                             // nInBufferSize(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 zu DeviceIoControl.

Sie können FSCTL_WRITE_USN_CLOSE_RECORD verwenden, um einen schließenden Datensatz im Änderungsjournal für das Eingabehandle zu erzwingen. Der Schließendatensatz enthält auch alle aktuellen USN-Gründe für diese Datei. Der Ausgabepuffer gibt den USN-Wert zurück, der diesem Vorgang zugeordnet ist.

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

Transaktionierte Vorgänge

Wenn FSCTL_WRITE_USN_CLOSE_RECORD mit einem Handle aufgerufen wird, das durch eine Transaktion gesperrt ist, tritt immer ein Fehler 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)

Weitere Informationen

Volumeverwaltungs-Steuerungscodes