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_UPDATE_OVERLAY atualiza um novo identificador de fonte de dados para uma fonte de backup anexada a um volume.
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 para o qual a sobreposição é atualizada. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . O identificador do volume para o qual a sobreposição é atualizada. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: o código de controle da operação. Use FSCTL_UPDATE_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. Se o provedor for um arquivo WIM, uma estrutura de WIM_PROVIDER_UPDATE_OVERLAY_INPUT será incluída 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]: não usado. Definido como NULL.
OutputBufferLength [in]: Definido como 0.
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 entrada apontado por InputBuffer e especificado por InputBufferLength é 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 dados a ser atualizada for um arquivo WIM (Formato de Imagem do Windows), o buffer de entrada conterá uma estrutura WOF_EXTERNAL_INFO seguida por uma estrutura WIM_PROVIDER_UPDATE_OVERLAY_INPUT . O InputBufferLength nesse caso será sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_UPDATE_OVERLAY_INPUT). O valor DataSourceId em WIM_PROVIDER_UPDATE_OVERLAY_INPUT deve ser para um arquivo WIM adicionado anteriormente em uma solicitação de FSCTL_ADD_OVERLAY .
Outros provedores de backup definirão suas próprias estruturas de parâmetro de entrada 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) |