FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Artikel

Aktiviert das Bereichsnachverfolgungsfeature für den Änderungsjournalstream der Updatesequenznummer (USN) auf einem Zielvolume oder ändert bereits aktivierte Bereichsnachverfolgungsparameter.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to volume
  FSCTL_USN_TRACK_MODIFIED_RANGES,  // dwIoControlCode
  (LPDWORD) lpInBuffer,             // input buffer
  (DWORD) nInBufferSize,            // size of input buffer
  (LPDWORD) lpOutBuffer,            // lpOutbuffer
  (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 des Themas DeviceIoControl .

Sie können FSCTL_USN_TRACK_MODIFIED_RANGES verwenden, um die Bereichsnachverfolgung zum ersten Mal für ein Volume zu aktivieren. Nach der aktivierungsfähigen Bereichsnachverfolgung werden der Zustand und die Parameter für dieses Volume beibehalten, und beim nächsten Neustart wird die Bereichsnachverfolgung initialisiert, die aus den persistenten Parametern gelesen wird.

Sie können auch FSCTL_USN_TRACK_MODIFIED_RANGES verwenden, um einen vorhandenen Änderungsjournal-Streambereichsspurparameter zu ändern. Wenn die Bereichsnachverfolgung bereits vorhanden ist, legt FSCTL_USN_TRACK_MODIFIED_RANGES sie auf die Parameter fest, die in der USN_TRACK_MODIFIED_RANGES-Struktur bereitgestellt werden. Der Schwellenwert für die Blockgröße oder die Dateigröße kann nur gegenüber den vorherigen Werten gesenkt werden. Nach der Aktivierung kann die Bereichsnachverfolgungsfunktion nur deaktiviert werden, wenn das Journal gelöscht wird.

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

Dabei entspricht X dem Laufwerkbuchstaben des Volumes.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Weitere Informationen