Freigeben über

FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Artikel

Aktiviert die Bereichsnachverfolgungsfunktion für update sequence number (USN) change journal stream on a target volume, or modifies already enabled range tracking parameters.

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
);

Bemerkungen

Die Auswirkungen überlappender E/A für 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 Aktivierung der Bereichsnachverfolgung werden der Zustand und die Parameter für dieses Volume beibehalten, und beim nächsten Neustart wird die Bereichsnachverfolgung aus den beibehaltenen Parametern initialisiert.

Sie können auch FSCTL_USN_TRACK_MODIFIED_RANGES verwenden, um einen vorhandenen Änderungsjournaldatenstrombereich-Trackparameter 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 von vorherigen Werten verringert werden. Nach der Aktivierung kann die Bereichsnachverfolgungsfunktion nicht deaktiviert werden, es sei denn, das Journal wird gelöscht.

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

dabei ist X- der Laufwerkbuchstaben des Volumes.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8.1 [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2012 R2 [nur Desktop-Apps]
Header- winioctl.h (enthalten Windows.h)

Siehe auch