Compartilhar via


Função FltGetFileContext (fltkernel.h)

A rotina FltGetFileContext recupera um contexto que foi definido para um arquivo por uma determinada instância de driver de minifiltro.

Sintaxe

NTSTATUS FLTAPI FltGetFileContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Parâmetros

[in] Instance

Ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.

[in] FileObject

Ponteiro de objeto de arquivo para o arquivo. Esse parâmetro é necessário e não pode ser NULL.

[out] Context

Ponteiro para uma variável alocada pelo chamador que recebe o endereço do contexto. Esse parâmetro é necessário e não pode ser definido como NULL.

Retornar valor

FltGetFileContext retorna STATUS_SUCCESS quando retorna com êxito o contexto de arquivo solicitado. Caso contrário, ele retornará um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno Descrição
STATUS_NOT_FOUND Nenhum contexto correspondente foi encontrado neste arquivo no momento, portanto, o FltMgr definiu Context como NULL_CONTEXT. Este é um código de erro.
STATUS_NOT_SUPPORTED Não há suporte para contextos de arquivo para esse arquivo. Este é um código de erro.

Comentários

Para obter mais informações sobre contextos, consulte Sobre contextos de minifiltro.

Um driver de minifiltro chama FltGetFileContext para recuperar o contexto de arquivo que ele definiu para um determinado arquivo.

FltGetFileContext incrementa a contagem de referência no contexto para o qual o parâmetro Context aponta. Quando esse ponteiro de contexto não for mais necessário, o chamador deverá diminuir sua contagem de referência chamando FltReleaseContext. Portanto, cada chamada bem-sucedida para FltGetFileContext deve ser correspondida por uma chamada subsequente para FltReleaseContext.

Para definir um contexto de arquivo, chame FltSetFileContext.

Para alocar um novo contexto, chame FltAllocateContext.

Para excluir um contexto de arquivo, chame FltDeleteFileContext ou FltDeleteContext.

Para determinar se há suporte para contextos de arquivo para um determinado arquivo, chame FltSupportsFileContexts ou FltSupportsFileContextsEx.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Confira também

FLT_CONTEXT_REGISTRATION

FltAllocateContext

FltDeleteContext

FltDeleteFileContext

FltReleaseContext

FltSetFileContext

FltSupportsFileContexts

FltSupportsFileContextsEx