FSCTL_DELETE_EXTERNAL_BACKING codice di controllo

Articolo
02/12/2024

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.