Função FltQueryInformationByName (fltkernel.h)

Artigo
02/06/2025

A rotina FltQueryInformationByName retorna as informações solicitadas sobre um arquivo nomeado.

Sintaxe

NTSTATUS FLTAPI FltQueryInformationByName(
  [in]           PFLT_FILTER               Filter,
  [in, optional] PFLT_INSTANCE             Instance,
  [in]           POBJECT_ATTRIBUTES        ObjectAttributes,
  [out]          PIO_STATUS_BLOCK          IoStatusBlock,
  [out]          PVOID                     FileInformation,
  [in]           ULONG                     Length,
  [in]           FILE_INFORMATION_CLASS    FileInformationClass,
  [in, optional] PIO_DRIVER_CREATE_CONTEXT DriverContext
);

Parâmetros

[in] Filter

Especifica o filtro que está iniciando esta operação.

[in, optional] Instance

Especifica a instância para a qual a criação é direcionada.

Importante

de Instância não é necessariamente a instância inicial. Ele deve corresponder à instância para a qual a criação é direcionada, se esse parâmetro não forNULL. Se Instância não forNULL, o retorno de chamada de pré-criação do filtro atual não será chamado. Os pré-retornos de chamada começam com o filtro abaixo do filtro atual.

[in] ObjectAttributes

Ponteiro para uma estrutura [OBJECT_ATTRIBUTES] com os atributos a serem usados para o objeto de arquivo (por exemplo, seu nome, SECURITY_DESCRIPTOR etc.).

[out] IoStatusBlock

Ponteiro para uma estrutura IO_STATUS_BLOCK que contém o bloco de status de E/S do chamador.

[out] FileInformation

Ponteiro para uma estrutura que recebe as informações solicitadas retornadas sobre o arquivo. O tipo de estrutura é determinado por FileInformationClass.

[in] Length

O comprimento, em bytes, do buffer FileInformation.

[in] FileInformationClass

Um valor de enumeração FILE_INFORMATION_CLASS que especifica o tipo de informação a ser retornado sobre o arquivo. Pode ser um dos seguintes valores:

Valor	Tipo de estrutura que FileInformation aponta para
FileStatInformation	FILE_STAT_INFORMATION
FileStatLxInformation	**FILE_STAT_LX_INFORMATION
FileCaseSensitiveInformation	FILE_CASE_SENSITIVE_INFORMATION. O chamador deve ter aberto o arquivo com o sinalizador de FILE_READ_ATTRIBUTES especificado no parâmetro DesiredAccess. Esse valor está disponível a partir do Windows 10, versão 1803.
FileCaseSensitiveInformationForceAccessCheck	FILE_CASE_SENSITIVE_INFORMATION. Esta é uma versão especial da operação FileCaseSensitiveInformation que é usada para forçar o Gerenciador de E/S a executar verificações de acesso para o driver do modo kernel, semelhante às verificações que se aplicam a um chamador no modo de usuário. Essa operação é reconhecida apenas pelo Gerenciador de E/S e um sistema de arquivos nunca deve recebê-la. Esse valor está disponível a partir do Windows 10, versão 1803.

[in, optional] DriverContext

Um ponteiro para o espaço de contexto do driver.

Valor de retorno

Retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retornará um código de erro NTSTATUS apropriado.

Observações

Essa função retorna informações solicitadas sobre um arquivo sem abrir o arquivo real. As informações retornadas são determinadas pelo FileInformationClass especificado e são colocadas no buffer FileInformation do chamador.

Se Instância não for NULL, a criação será direcionada para a instância especificada, chamando todos os filtros abaixo do filtro atual antes de enviar a E/S para baixo. Se Instância for NULL, a E/S sempre será enviada para a parte superior da pilha de filtros.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1706
cabeçalho	fltkernel.h
biblioteca	FltMgr.lib
de DLL	Fltmgr.sys

Consulte também

FILE_INFORMATION_CLASS

Compartilhar via