FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)
Erstellt einen USN-Änderungsjournaldatenstrom (Update Sequence Number) auf einem Zielvolume oder ändert einen vorhandenen Änderungsjournaldatenstrom.
| C++ |
|---|
BOOL
WINAPI
DeviceIoControl( (HANDLE) hDevice, // handle to volume
FSCTL_CREATE_USN_JOURNAL, // dwIoControlCode(LPVOID) lpInBuffer, // input buffer
(DWORD) nInBufferSize, // size of input buffer
NULL, // lpOutBuffer
0, // nOutBufferSize(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" des Themas DeviceIoControl.
Sie können FSCTL_CREATE_USN_JOURNAL verwenden, um einen neuen Änderungsjournaldatenstrom für ein Volume zu erstellen. Nach der Erstellung des Datenstroms verwaltet das NTFS-Dateisystem ein Änderungsjournal für dieses Volume.
Sie können auch FSCTL_CREATE_USN_JOURNAL verwenden, um einen vorhandenen Änderungsjournaldatenstrom zu ändern. Wenn bereits ein Änderungsjournaldatenstrom vorhanden ist, legt FSCTL_CREATE_USN_JOURNAL ihn auf die in der CREATE_USN_JOURNAL_DATA Struktur bereitgestellten Merkmale fest. Der Änderungsjournaldatenstrom wird schließlich größer oder wird auf die neue Größenbeschränkung gekürzt, die CREATE_USN_JOURNAL_DATA aufzwingt.
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 Server 2012 wird diese Funktion 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 |
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) |