codice di controllo FSCTL_REMOVE_OVERLAY

Articolo
03/14/2023

Il codice di controllo FSCTL_REMOVE_OVERLAY rimuove un'origine di backup da un volume.

Per eseguire questa operazione, chiamare FltFsControlFile o ZwFsControlFile con i parametri seguenti.

Parametri

Istanza [in]: solo FltFsControlFile . Puntatore di istanza opaco per il chiamante. Questo parametro è obbligatorio e non può essere NULL.
FileObject [in]: solo FltFsControlFile . Oggetto puntatore al file del volume da cui viene rimossa la sovrimpressione. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: Solo ZwFsControlFile . Handle del volume per il quale viene rimossa la sovrimpressione. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_REMOVE_OVERLAY per questa operazione.
InputBuffer [in]: puntatore al buffer di input, che deve contenere una struttura WOF_EXTERNAL_INFO . Se necessario, i dati specifici del provider aggiuntivi vengono inclusi immediatamente dopo WOF_EXTERNAL_INFO. Se il provider è un file WIM, dopo WOF_EXTERNAL_INFO viene inclusa una struttura di WIM_PROVIDER_REMOVE_OVERLAY_INPUT.
InputBufferLength [in]: impostare su sizeof(WOF_EXTERNAL_INFO) più le dimensioni di eventuali dati di input del provider aggiuntivi.
OutputBuffer [out]: non usato. Impostata su NULL.
OutputBufferLength [in]: impostato su 0.

Blocco dello stato

FltFsControlFile o ZwFsControlFile restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, la funzione appropriata potrebbe restituire uno dei valori NTSTATUS seguenti.

Codice	Significato
STATUS_ACCESS_DENIED	Il richiedente non dispone di privilegi amministrativi.
STATUS_BUFFER_TOO_SMALL	La lunghezza del buffer di output a cui punta OutputBuffer e specificata da OutputBufferLength è troppo piccola.
STATUS_INTERNAL_ERROR	Il volume richiesto non è accessibile.
STATUS_INVALID_DEVICE_REQUEST	Il servizio di backup non è presente o non è stato avviato.

Commenti

Quando l'origine di backup da rimuovere è un file WIM (Windows Imaging Format), il buffer di input conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura WIM_PROVIDER_REMOVE_OVERLAY_INPUT . In questo caso InputBufferLength sarà sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT). Il valore DataSourceId in WIM_PROVIDER_REMOVE_OVERLAY_INPUT deve essere per un file WIM aggiunto in precedenza in una richiesta di FSCTL_ADD_OVERLAY .

Altri provider di backup definiranno le proprie strutture di parametri di input specifiche.