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_EXTERNAL_BACKING começa ou continua uma enumeração de arquivos em um volume que tem uma fonte de backup. Para cada conclusão bem-sucedida da solicitação, um identificador para o arquivo com backup é retornado. Todos os arquivos com suporte são enumerados independentemente de qual provedor externo esteja fazendo backup dele. Solicitações FSCTL_ENUM_EXTERNAL_BACKING sucessivas são necessárias para enumerar todos os arquivos com backup no volume.
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_ENUM_EXTERNAL_BACKING para esta operação.
InputBuffer [in]: Nenhum. Definir como NULL.
InputBufferLength [in]: Definido como 0.
OutputBuffer [out]: um ponteiro para o buffer de saída, que deve ter um tamanho grande o suficiente para receber uma ou mais estruturas WOF_EXTERNAL_FILE_ID .
OutputBufferLength [out]: tamanho do buffer de saída apontado por OutputBuffer. OutputBufferLength deve ser >= sizeof(WOF_EXTERNAL_FILE_ID).
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. |
| STATUS_NO_MORE_FILES | Não há mais arquivos no volume que tenham uma fonte de backup. |
| 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
A estrutura de WOF_EXTERNAL_FILE_ID retornada no OutputBuffer contém identificadores de arquivo exclusivos para arquivos com backup. A estrutura é definida em ntifs.h como a seguir.
typedef struct _WOF_EXTERNAL_FILE_ID {
FILE_ID_128 FileId;
} WOF_EXTERNAL_FILE_ID, *PWOF_EXTERNAL_FILE_ID;
Uma solicitação FSCTL_ENUM_EXTERNAL_BACKING é emitida sucessivamente para recuperar os identificadores de cada arquivo no volume que tem a origem de backup. Quando todos os arquivos são enumerados, o código de status STATUS_NO_MORE_FILES é retornado.
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