Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |