FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)

  • Artikel

Erstellt einen Änderungsjournalstream der Updatesequenznummer (USN) auf einem Zielvolume oder ändert einen vorhandenen Änderungsjournalstream.

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

Hinweise

Die Auswirkungen von überlappenden E/A-Vorgängen auf 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 Streams 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 festlegt.

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 Server 2012 wird diese Funktion 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

CREATE_USN_JOURNAL_DATA

Änderungsjournale

CreateFile

DeviceIoControl

OVERLAPPED

Volumeverwaltungs-Steuerungscodes