FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Articolo

Abilita la funzionalità di rilevamento dell'intervallo per il flusso del journal di modifica della sequenza di aggiornamento (USN) in un volume di destinazione o modifica i parametri di rilevamento dell'intervallo già abilitati.

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

Commenti

Per le implicazioni dell'I/O sovrapposta in questa operazione, vedere la sezione Osservazioni dell'argomento DeviceIoControl .

È possibile usare FSCTL_USN_TRACK_MODIFIED_RANGES per abilitare il rilevamento degli intervalli per la prima volta per un volume. Dopo l'abilitazione del rilevamento intervallo, lo stato e i parametri verranno mantenuti per tale volume e al riavvio successivo il rilevamento dell'intervallo verrà inizializzato dai parametri persistenti.

È anche possibile usare FSCTL_USN_TRACK_MODIFIED_RANGES per modificare un parametro di traccia dell'intervallo di flusso del journal di modifiche esistente. Se il rilevamento dell'intervallo esiste già, FSCTL_USN_TRACK_MODIFIED_RANGES impostarlo sui parametri forniti nella struttura USN_TRACK_MODIFIED_RANGES . La soglia delle dimensioni del blocco o delle dimensioni del file può essere ridotta solo dai valori precedenti. Una volta abilitata, la funzionalità di rilevamento dell'intervallo non può essere disabilitata a meno che il journal non venga eliminato.

Per recuperare un handle in un volume, chiamare CreateFile con il parametro lpFileName impostato su una stringa nel formato seguente:

\\.\X:

Nella stringa precedente, X è la lettera che identifica l'unità in cui viene visualizzato il volume. Il volume deve essere NTFS 3.0 o versione successiva. Per ottenere la versione NTFS di un volume, aprire un prompt dei comandi con diritti di accesso amministratore ed eseguire il comando seguente:

fsutil fsinfo ntfsinfoX:

dove X è la lettera di unità del volume.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1 [solo app desktop]
Server minimo supportato Windows Server 2012 R2 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche