Condividi tramite

FSCTL_DELETE_EXTERNAL_BACKING codice di controllo

  • Articolo

Il codice di controllo FSCTL_DELETE_EXTERNAL_BACKING rimuove l'associazione di un file con un provider di backup esterno, incluso il provider di file wim (Windows Image Format) o il provider di file compressi. A seguito di questa operazione, l'intero contenuto di un file supportato viene letto, decompresso e scritto nel file.

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

Parametri

  • Istanza [in]: Solo FltFsControlFile . Puntatore opaco dell'istanza per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

  • FileObject: [in]: Solo FltFsControlFile . Oggetto puntatore file del file per cui viene eliminata l'associazione di backup. Questo parametro è obbligatorio e non può essere NULL.

  • FileHandle [in]: ZwFsControlFile solo. Handle del file per il quale viene eliminata l'associazione di backup. Questo parametro è obbligatorio e non può essere NULL.

  • FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_DELETE_EXTERNAL_BACKING per questa operazione.

  • InputBuffer [in]: Nessuno. Impostata su NULL.

  • InputBufferLength [in]: Impostare su 0.

  • OutputBuffer [out]: Nessuno. Impostata su NULL.

  • OutputBufferLength [out]: Impostare 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_OBJECT_NOT_EXTERNALLY_BACKED Il file non è supportato esternamente.
STATUS_INVALID_DEVICE_REQUEST Il servizio di backup non è presente o non è avviato.
STATUS_ACCESS_DENIED Il richiedente non dispone dell'autorizzazione per eliminare le associazioni di backup per il file.

Commenti

A seguito dell'operazione di eliminazione, il contenuto del file viene letto dall'origine di backup e l'intero file viene scritto nel volume.

Requisiti

Tipo di requisito Requisito
Client minimo supportato Windows 8.1 Update
Intestazione Ntifs.h (include Ntifs.h o Fltkernel.h)

Vedi anche

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING