Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O código de controle FSCTL_ENUM_OVERLAY enumera todas as fontes de dados de um provedor de backup para um volume especificado.
Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.
Parâmetros
Instância [in]: somente FltFsControlFile . Ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.
FileObject [in]: somente FltFsControlFile . O objeto de ponteiro de arquivo que especifica o volume a ser desmontado. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . O identificador de arquivo do volume a ser desmontado. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: controlar o código da operação. Use FSCTL_REMOVE_OVERLAY para esta operação.
InputBuffer [in]: um ponteiro para o buffer de entrada, que deve conter uma estrutura WOF_EXTERNAL_INFO .
InputBufferLength [in]: Definido como sizeof(WOF_EXTERNAL_INFO).
OutputBuffer [out]: ponteiro para um buffer de saída que receberá uma ou mais estruturas WIM_PROVIDER_OVERLAY_ENTRY para fontes de dados que dão suporte ao volume.
OutputBufferLength [out]: tamanho do buffer apontado por OutputBuffer, em bytes.
LengthReturned [out]: especifica o número de bytes gravados no OutputBuffer após a conclusão bem-sucedida.
Bloco de status
FltFsControlFile ou ZwFsControlFile retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, a função apropriada poderá retornar um dos seguintes valores NTSTATUS.
| Code | Significado |
|---|---|
| STATUS_ACESSO_NEGADO | O solicitante não tem privilégios administrativos. |
| STATUS_BUFFER_TOO_SMALL | O comprimento do buffer de saída apontado por OutputBuffer e especificado por OutputBufferLength é muito pequeno. |
| ERRO_INTERNO_DE_SISTEMA | O volume solicitado não está acessível. |
| STATUS_INVALID_DEVICE_REQUEST | O serviço de backup não está presente ou não foi iniciado. |
Observações
Ao enumerar as fontes de dados para o provedor WIM, o buffer de saída conterá uma matriz de estruturas de WIM_PROVIDER_OVERLAY_ENTRY . O tamanho do buffer de saída deve ser grande o suficiente para conter todas as entradas de sobreposição ou a chamada retornará STATUS_BUFFER_TOO_SMALL.
Provedores de backup adicionais definirão suas próprias estruturas de enumeração específicas.
Requisitos
| Tipo de requisito | Requisito |
|---|---|
| Cliente mínimo com suporte | Atualização do Windows 8.1 |
| Cabeçalho | Ntifs.h (inclua Ntifs.h ou Fltkernel.h) |
Consulte também