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_ADD_OVERLAY adiciona uma nova fonte de backup externo ao namespace de um volume. Essa fonte de backup pode ser um arquivo WIM (Formato de Imagem do Windows).
Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.
Parâmetros
Instância [in]: somente FltFsControlFile . Um 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 do volume ao qual a sobreposição é adicionada. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . O identificador do volume ao qual a sobreposição é adicionada. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: o código de controle da operação. Use FSCTL_ADD_OVERLAY para esta operação.
InputBuffer [in]: um ponteiro para o buffer de entrada, que deve conter uma estrutura WOF_EXTERNAL_INFO . Quando necessário, dados específicos do provedor adicionais são incluídos imediatamente após WOF_EXTERNAL_INFO.
InputBufferLength [in]: defina como sizeof(WOF_EXTERNAL_INFO) mais o tamanho de quaisquer dados de entrada de provedor adicionais.
OutputBuffer [out]: um ponteiro para o buffer de saída, que contém qualquer informação resultante da operação de adição.
OutputBufferLength [out]: tamanho do buffer apontado por OutputBuffer.
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
Quando a fonte de backup adicionada for um arquivo WIM (Formato de Imagem do Windows), o buffer de entrada conterá uma estrutura WOF_EXTERNAL_INFO seguida por uma estrutura de WIM_PROVIDER_ADD_OVERLAY_INPUT . O InputBufferLength nesse caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_ADD_OVERLAY_INPUT). Após a conclusão da solicitação, os dados apontados pelo OutputBuffer contêm um único valor LARGE_INTEGER que é o novo identificador da fonte de dados para o arquivo WIM.
Outros provedores de backup definirão suas próprias estruturas de parâmetro de entrada específicas e tipos de dados de saída.
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) |