FSCTL_MARK_HANDLE IOCTL (winioctl.h)

  • Articolo

Contrassegna un file o una directory specificata e il relativo record del journal di modifica con informazioni sulle modifiche apportate a tale file o directory.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl usando i parametri seguenti.

BOOL DeviceIoControl(
  (HANDLE) hDevice,             // handle to file or directory
  FSCTL_MARK_HANDLE,            // dwIoControlCode
  (LPVOID)lpInBuffer,           // input buffer
  (DWORD)nInBufferSize,         // size of input buffer
  NULL,                         // lpOutBuffer
  0,                            // nOutBufferSize
  (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 .

FSCTL_MARK_HANDLE è l'unica operazione di journal di modifica che opera su un singolo file o directory. Non influisce su alcun elemento che l'utente può fare con l'elemento. Aggiunge invece informazioni al file o alla directory, fornendo informazioni su come il sistema operativo ha modificato l'elemento o aggiungendo un flusso di dati privato all'elemento.

Se si verificano modifiche al file o alla directory, le informazioni aggiunte con FSCTL_MARK_HANDLE vengono copiate anche nel record USN creato per il file o la directory. Si noti che queste due operazioni possono verificarsi indipendentemente l'una dall'altra, ad esempio non è necessario che un record USN esista per essere in grado di contrassegnare un file come non può essere deframmentato e non è necessario contrassegnare un file o una directory per aggiornare il contenuto del record USN corrispondente. Per informazioni dettagliate sulle informazioni con cui FSCTL_MARK_HANDLE può contrassegnare un elemento (vedere MARK_HANDLE_INFO per altre informazioni).

Non è un errore usare FSCTL_MARK_HANDLE mentre il journal di modifica del volume viene eliminato o è inattivo. Le informazioni appropriate vengono applicate al file o alla directory indipendentemente dallo stato del journal di modifica, purché esista il journal di modifica.

Si noti che i timestamp potrebbero non essere aggiornati correttamente per un file remoto. Per garantire risultati coerenti, usare I/O non memorizzati.

Il volume deve essere NTFS.

In Windows 8 e Windows Server 2012 questo codice è supportato dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 No
Failover trasparente SMB 3.0 (TFO) No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) No
File system del volume condiviso del cluster (CsvFS) Sì

CsvFs genera sempre problemi USN_SOURCE_REPLICATION_MANAGEMENT e MARK_HANDLE_PROTECT_CLUSTERS per i file idonei per l'I/O diretto.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche