Função FsRtlQueryInformationFile (ntifs.h)

Artigo
12/21/2024

FsRtlQueryInformationFile cria um IRP (informações de consulta de arquivo) explícito (IRP_MJ_QUERY_INFORMATION), envia-o para baixo na pilha, espera síncronamente para que ele seja concluído e retorna o resultado. Essa função permite que o chamador conclua essa ação FileObject em vez de manipular.

Sintaxe

NTSTATUS FsRtlQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass,
  [out] PULONG                 RetFileInformationSize
);

Parâmetros

[in] FileObject

Ponteiro para o FILE_OBJECT para enviar a operação.

[out] FileInformation

Ponteiro para um buffer alocado por chamador para receber as informações do arquivo consultado.

[in] Length

Tamanho em bytes do buffer para o qual FileInformation aponta.

[in] FileInformationClass

Um valor FILE_INFORMATION_CLASS que especifica o tipo de informação de arquivo que está sendo consultada.

[out] RetFileInformationSize

Recebe o número de bytes gravados (retornados) no buffer para o qual FileInformation aponta.

Valor de retorno

FsRtlKernelFsControlFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes.

Valor	Significado
STATUS_INSUFFICIENT_RESOURCES	Ocorreu uma falha de alocação de pool.
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi fornecido (por exemplo, umFileObject inválido).

Observações

Essa rotina pressupõe que todos os buffers passados são buffers no modo kernel.

Requisitos

Requisito	Valor
cabeçalho	ntifs.h

Consulte também

ZwQueryInformationFile

Compartilhar via