FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)
Generiert einen Datensatz im USN-Änderungsjournaldatenstrom (Update Sequence Number) für die Eingabedatei. Dieser Datensatz hat das USN_REASON_CLOSE Flag.
Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl--Funktion 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
|
Bemerkungen
Die Auswirkungen überlappender E/A für diesen Vorgang finden Sie im Abschnitt "Hinweise" für DeviceIoControl-.
Sie können FSCTL_WRITE_USN_CLOSE_RECORD verwenden, um einen schließenden Datensatz in das Änderungsjournal für das Eingabehandle zu erzwingen. Der schließene Datensatz 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 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 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 ist X- der Laufwerkbuchstaben des Volumes.
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) | Ja |
Transacted Operations
Wenn FSCTL_WRITE_USN_CLOSE_RECORD mit einem Handle aufgerufen wird, das durch eine Transaktion gesperrt ist, schlägt dies immer fehl.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) |