FSCTL_ENUM_OVERLAY código de controle

Artigo
02/07/2024

O código de controle FSCTL_ENUM_OVERLAY enumera todas as fontes de dados de um provedor de suporte para um volume especificado.

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]: código de controle para a operação. Use FSCTL_REMOVE_OVERLAY para esta operação.
InputBuffer [in]: um ponteiro para o buffer de entrada, que deve conter uma estrutura WOF_EXTERNAL_INFO .
InputBufferLength [in]: defina como sizeof(WOF_EXTERNAL_INFO).
OutputBuffer [out]: ponteiro para um buffer de saída que receberá uma ou mais estruturas WIM_PROVIDER_OVERLAY_ENTRY para fontes de dados que dão suporte ao volume.
OutputBufferLength [out]: tamanho do buffer apontado por OutputBuffer, em bytes.
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_ACCESS_DENIED	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_INTERNAL_ERROR	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.

Comentários

Ao enumerar as fontes de dados para o provedor WIM, o buffer de saída conterá uma matriz de estruturas WIM_PROVIDER_OVERLAY_ENTRY . O tamanho do buffer de saída deve ser grande o suficiente para conter todas as entradas de sobreposição ou a chamada retornará STATUS_BUFFER_TOO_SMALL.

Provedores de suporte adicionais definirão suas próprias estruturas de enumeração específicas.