código de controle FSCTL_GET_EXTERNAL_BACKING

Artigo
02/02/2024

O código de controle FSCTL_GET_EXTERNAL_BACKING obtém as informações de backup de um arquivo de um provedor de suporte externo. Os provedores de suporte incluem o provedor wim (formato de imagem do Windows) ou o provedor de arquivos compactados individual. O conteúdo de arquivos com backup externo pode residir em volumes diferentes do volume que contém o arquivo consultado.

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 arquivo para o qual as informações de backup são consultadas. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . O identificador do arquivo para o qual as informações de backup são consultadas. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: um código de controle para a operação. Use FSCTL_GET_EXTERNAL_BACKING para esta operação.
InputBuffer [in]: Nenhum. Defina 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 estrutura de WOF_EXTERNAL_INFO seguida pelos dados do provedor. Para arquivos com backup de WIM, WOF_EXTERNAL_INFO é seguido por uma estrutura de WIM_PROVIDER_EXTERNAL_INFO . Para arquivos compactados individualmente, WOF_EXTERNAL_INFO é seguido por uma estrutura FILE_PROVIDER_EXTERNAL_INFO_V1 .
OutputBufferLength [out]: tamanho, em bytes, do buffer apontado por OutputBuffer.
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 pode retornar um dos seguintes valores NTSTATUS.

Código	Significado
STATUS_OBJECT_NOT_EXTERNALLY_BACKED	O arquivo não tem backup externo.
STATUS_INVALID_DEVICE_REQUEST	O serviço de backup não está presente ou não foi iniciado.

Comentários

Quando o provedor de backup da fonte de dados a ser atualizada for um arquivo WIM, o buffer de saída conterá uma estrutura de WOF_EXTERNAL_INFO seguida por uma estrutura WIM_PROVIDER_EXTERNAL_INFO . O OutputBufferLength deve ser pelo menos sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO). Quando o provedor de suporte for um arquivo compactado individualmente, o buffer de saída conterá uma estrutura WOF_EXTERNAL_INFO seguida por uma estrutura FILE_PROVIDER_EXTERNAL_INFO_V1 .