Função FltIsDirectory (fltkernel.h)

  • Artigo

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á TRUE se o objeto de arquivo representar um diretório; caso contrário, FALSE .

Retornar valor

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, o FltIsDirectory retornará informações de diretório mesmo para sistemas de arquivos que não dão suporte a contextos de fluxo.

Comentários

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 nesse fluxo.

Nota Essa rotina só pode ser chamada em um objeto de arquivo aberto.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Essa rotina está disponível no Pacote Cumulativo de Atualizações 1 do Microsoft Windows 2000 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.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua FltKernel.h)
Biblioteca Fltmgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Confira também

FsRtlSupportsPerStreamContexts