Condividi tramite

FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Articolo

Abilita la funzionalità di rilevamento dell'intervallo per il flusso del journal delle modifiche del numero di 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
);

Osservazioni

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

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

È anche possibile usare FSCTL_USN_TRACK_MODIFIED_RANGES per modificare un parametro di rilevamento dell'intervallo di flussi del journal di modifiche esistente. Se il rilevamento dell'intervallo esiste già, FSCTL_USN_TRACK_MODIFIED_RANGES lo imposta sui parametri forniti nella struttura USN_TRACK_MODIFIED_RANGES. Le dimensioni del blocco o la soglia delle dimensioni del file possono essere inferiori solo rispetto ai 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.

Fabbisogno

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)

Vedere anche