FSCTL_UPDATE_OVERLAY codice di controllo
Il codice di controllo FSCTL_UPDATE_OVERLAY aggiorna un nuovo identificatore dell'origine dati per un'origine di backup collegata a un volume.
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 volume per il quale viene aggiornata la sovrapposizione. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: ZwFsControlFile solo. Handle del volume per il quale viene aggiornata la sovrapposizione. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_UPDATE_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 aggiuntivo vengono inclusi immediatamente dopo WOF_EXTERNAL_INFO. Se il provider è un file WIM, una struttura WIM_PROVIDER_UPDATE_OVERLAY_INPUT viene inclusa dopo WOF_EXTERNAL_INFO.
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]: 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_ACCESS_DENIED | Il richiedente non ha privilegi amministrativi. |
| STATUS_BUFFER_TOO_SMALL | La lunghezza del buffer di input puntata da InputBuffer e specificata da InputBufferLength è 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 l'origine dati da aggiornare è un file WIM (Windows Imaging Format), il buffer di input conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura WIM_PROVIDER_UPDATE_OVERLAY_INPUT . InputBufferLength in questo caso sarà sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_UPDATE_OVERLAY_INPUT). Il valore DataSourceId in WIM_PROVIDER_UPDATE_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.
Requisiti
| Tipo di requisito | Requisito |
|---|---|
| Client minimo supportato | Windows 8.1 Update |
| Intestazione | Ntifs.h (include Ntifs.h o Fltkernel.h) |