Função FltIsDirectory (fltkernel.h)

Artigo
02/06/2025

Um driver de minifiltro chama a rotina FltIsDirectory para determinar se um determinado objeto de arquivo representa um diretório.

Sintaxe

NTSTATUS FLTAPI FltIsDirectory(
  [in]  PFILE_OBJECT  FileObject,
  [in]  PFLT_INSTANCE Instance,
  [out] PBOOLEAN      IsDirectory
);

Parâmetros

[in] FileObject

Ponteiro para um objeto de arquivo já aberto.

[in] Instance

Ponteiro de instância opaca para a instância associada a esse objeto de arquivo.

[out] IsDirectory

Ponteiro para uma variável booliana fornecida pelo chamador. No retorno, essa variável receberá verdadeiro se o objeto de arquivo representar um diretório, FALSE caso contrário.

Valor de retorno

FltIsDirectory retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno	Descrição
STATUS_NOT_SUPPORTED	Esse código de erro será retornado se o sistema de arquivos não der suporte a contextos de fluxo. Observe que, a partir do Windows Vista, FltIsDirectory retornará informações de diretório mesmo para sistemas de arquivos que não dão suporte a contextos de fluxo.

Observações

FltIsDirectory recupera as informações desejadas do gerenciador de contexto de fluxo interno do gerenciador de filtros. O gerenciador de filtros armazena essas informações em cache para consultas futuras neste fluxo.

Observação Essa rotina só pode ser chamada em um objeto de arquivo aberto.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Essa rotina está disponível no Pacote Cumulativo de Atualizações do Microsoft Windows 2000 1 para SP4, Windows XP SP2, Microsoft Windows Server 2003 SP1 e posterior. Observe que essa rotina não está disponível no Windows 2000 SP4 ou anterior.
da Plataforma de Destino	Universal
cabeçalho	fltkernel.h (inclua FltKernel.h)
biblioteca	Fltmgr.lib
de DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

Consulte também

FsRtlSupportsPerStreamContexts

Compartilhar via