Condividi tramite


FSCTL_SUSPEND_OVERLAY codice di controllo

Il codice di controllo FSCTL_SUSPEND_OVERLAY sospende un'origine di backup collegata a un volume, impedendo l'accesso all'origine di backup e consentendone la modifica o la rimozione.

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

BOOL 
   WINAPI 
   DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                    (DWORD)        FSCTL_SUSPEND_OVERLAY, // dwIoControlCode
                    (LPDWORD)      lpInBuffer,      // input buffer
                    (DWORD)        nInBufferSize,   // size of input buffer
                    (LPDWORD)      lpOutBuffer,     // output buffer
                    (DWORD)        nOutBufferSize,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

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_SUSPEND_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 di WIM_PROVIDER_SUSPEND_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 di backup da rimuovere è un file WIM (Windows Imaging Format), il buffer di input conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura WIM_PROVIDER_SUSPEND_OVERLAY_INPUT . InputBufferLength in questo caso sarà sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT). Il valore DataSourceId in WIM_PROVIDER_SUSPEND_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
Intestazione Ntifs.h (include Ntifs.h o Fltkernel.h)

Vedi anche

FSCTL_REMOVE_OVERLAY

FSCTL_UPDATE_OVERLAY

FSCTL_GET_EXTERNAL_BACKING

FSCTL_SET_EXTERNAL_BACKING