código de controle FSCTL_DELETE_EXTERNAL_BACKING

Artigo
03/14/2023

O código de controle FSCTL_DELETE_EXTERNAL_BACKING remove a associação de um arquivo com um provedor de suporte externo, incluindo o provedor WIM (Windows Image Format) ou o provedor de arquivos compactados. Como resultado dessa operação, todo o conteúdo de um arquivo com suporte é lido, descompactado e gravado no arquivo.

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 a associação de backup é excluída. Esse parâmetro é necessário e não pode ser NULL.
FileHandle [in]: somente ZwFsControlFile . O identificador do arquivo para o qual a associação de backup é excluída. Esse parâmetro é necessário e não pode ser NULL.
FsControlCode [in]: o código de controle da operação. Use FSCTL_DELETE_EXTERNAL_BACKING para esta operação.
InputBuffer [in]: Nenhum. Definido como NULL.
InputBufferLength [in]: definido como 0.
OutputBuffer [out]: Nenhum. Definido como NULL.
OutputBufferLength [out]: 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 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.
STATUS_ACCESS_DENIED	O solicitante não tem permissão para excluir as associações de suporte para o arquivo.