FSCTL_ENUM_OVERLAY codice di controllo
Il codice di controllo FSCTL_ENUM_OVERLAY enumera tutte le origini dati da un provider di backup per un volume specificato.
Per eseguire questa operazione, chiamare FltFsControlFile o ZwFsControlFile con i parametri seguenti.
Parametri
Istanza [in]: Solo FltFsControlFile . Puntatore istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.
FileObject [in]: Solo FltFsControlFile . Oggetto puntatore file che specifica il volume da smontare. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: ZwFsControlFile solo. Handle di file del volume da smontare. 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 .
InputBufferLength [in]: Impostare su sizeof(WOF_EXTERNAL_INFO).
OutputBuffer [out]: Puntatore a un buffer di output che riceverà una o più strutture WIM_PROVIDER_OVERLAY_ENTRY per le origini dati che esegue il backup del volume.
OutputBufferLength [out]: Dimensioni del buffer a cui punta outputBuffer, in byte.
LengthReturned [out]: specifica il numero di byte scritti in OutputBuffer al completamento corretto.
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 ha privilegi amministrativi. |
| STATUS_BUFFER_TOO_SMALL | La lunghezza del buffer di output puntata da 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 è avviato. |
Commenti
Quando enumera le origini dati per il provider WIM, il buffer di output conterrà una matrice di strutture WIM_PROVIDER_OVERLAY_ENTRY . Le dimensioni del buffer di output devono essere sufficienti per contenere tutte le voci di sovrapposizione o la chiamata restituirà STATUS_BUFFER_TOO_SMALL.
Altri provider di backup definiranno le proprie strutture di enumerazione specifiche.
Requisiti
| Tipo di requisito | Requisito |
|---|---|
| Client minimo supportato | Windows 8.1 Update |
| Intestazione | Ntifs.h (include Ntifs.h o Fltkernel.h) |