FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

Aktiviert die Bereichsnachverfolgung für den USN-Änderungsjournaldatenstrom (Update Sequence Number) auf einem Zielvolume oder ändert bereits aktivierte Bereichsverfolgungsparameter.

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

Weitere Details zu den Auswirkungen überlappender E/A für diesen Vorgang finden Sie in den DeviceIoControl-Hinweisen.

FSCTL_USN_TRACK_MODIFIED_RANGES können verwendet werden, um die Bereichsnachverfolgung zum ersten Mal auf einem Volume zu aktivieren. Nach dem Aktivieren der Bereichsnachverfolgung werden der Zustand und die Parameter für dieses Volume beibehalten (beim Neustart wird die Bereichsnachverfolgung aus den beibehaltenen Parametern initialisiert).

FSCTL_USN_TRACK_MODIFIED_RANGES können auch verwendet werden, um einen vorhandenen Parameter für den Änderungsjournaldatenstrombereich 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 das Bereichsverfolgungsfeature nicht deaktiviert werden, es sei denn, das Journal wird gelöscht.

Zum Abrufen eines Handles zu einem Volume rufen Sie 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 (wobei X der Laufwerkbuchstaben des Volumes ist): fsutil fsinfo ntfsinfo X:

Irp-IoStatus.Status> ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird der Status als NTSTATUS-Code auf die entsprechende Fehlerbedingung festgelegt. Weitere Informationen finden Sie unter NTSTATUS Values.

Anforderungen

Siehe auch

• DeviceIoControl