codice di controllo FSCTL_GET_EXTERNAL_BACKING

Articolo
03/14/2023

Il codice di controllo FSCTL_GET_EXTERNAL_BACKING ottiene le informazioni di supporto per un file da un provider di supporto esterno. I provider di backup includono il provider Windows Image Format (WIM) o il provider di file compressi singoli. Il contenuto per i file con backup esterno può risiedere in volumi diversi dal volume contenente il file sottoposto a query.

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 di file del file su cui viene eseguita una query sulle informazioni di backup. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: Solo ZwFsControlFile . Handle del file per il quale viene eseguita una query sulle informazioni di backup. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_GET_EXTERNAL_BACKING per questa operazione.
InputBuffer [in]: Nessuno. Impostare su NULL.
InputBufferLength [in]: impostato su 0.
OutputBuffer [out]: puntatore al buffer di output, che deve avere dimensioni sufficienti per ricevere una struttura WOF_EXTERNAL_INFO seguita dai dati del provider. Per i file supportati da WIM, WOF_EXTERNAL_INFO è seguito da una struttura WIM_PROVIDER_EXTERNAL_INFO . Per i file compressi singolarmente, WOF_EXTERNAL_INFO è seguito da una struttura FILE_PROVIDER_EXTERNAL_INFO_V1 .
OutputBufferLength [out]: dimensioni, in byte, del buffer a cui punta OutputBuffer.
LengthReturned [out]: specifica il numero di byte scritti in OutputBuffer al completamento.

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 è stato avviato.

Commenti

Quando il provider di backup per l'origine dati da aggiornare è un file WIM, il buffer di output conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura WIM_PROVIDER_EXTERNAL_INFO . OutputBufferLength deve essere almeno sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO). Quando il provider di backup è un file compresso singolarmente, il buffer di output conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura FILE_PROVIDER_EXTERNAL_INFO_V1 .