Função FsRtlLookupPerFileObjectContext (ntifs.h)

Para um driver de filtro do sistema de arquivos "herdado", a função FsRtlLookupPerFileObjectContext recupera informações de contexto anteriormente associadas a um objeto de arquivo.

Sintaxe

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

Parâmetros

[in] FileObject

Um ponteiro para um objeto de arquivo para o qual consultar informações de contexto.

[in, optional] OwnerId

Um ponteiro para uma variável alocada pelo chamador que identifica exclusivamente o filtro proprietário da estrutura de contexto por objeto de arquivo. O formato dessa variável é específico do driver de filtro.

[in, optional] InstanceId

Um ponteiro para uma variável alocada por chamador que pode ser usada para distinguir entre estruturas de contexto por objeto de arquivo criadas pelo mesmo driver de filtro. O formato dessa variável é específico do driver de filtro. Esse parâmetro é opcional e pode ser NULL.

Retornar valor

FsRtlLookupPerFileObjectContext retorna um ponteiro para o primeiro contexto correspondente por objeto de arquivo encontrado. Se nenhuma correspondência for encontrada, FsRtlLookupPerFileObjectContext retornará NULL.

Comentários

Um driver de filtro do sistema de arquivos "herdado" chama FsRtlLookupPerFileObjectContext para recuperar sua estrutura de contexto por objeto de arquivo para um objeto de arquivo. A estrutura de contexto contém informações de contexto que o driver de filtro mantém para o objeto de arquivo. Essa estrutura de contexto deve ter sido associada anteriormente ao objeto de arquivo chamando a função FsRtlInsertPerFileObjectContext .

Se a estrutura FSRTL_PER_FILEOBJECT_CONTEXT for inserida em uma estrutura de contexto por arquivo-objeto definida por filtro, a macro CONTAINING_RECORD poderá ser usada para obter um ponteiro para o cabeçalho da estrutura definida pelo filtro.

Para inicializar uma estrutura de contexto por objeto de arquivo, use a macro FsRtlInitPerFileObjectContext .

Para associar uma estrutura de contexto por arquivo-objeto inicializada a um objeto de arquivo, use a função FsRtlInsertPerFileObjectContext .

Para remover uma estrutura de contexto por objeto de arquivo associada a um objeto de arquivo, use a função FsRtlRemovePerFileObjectContext .

Requisitos

Confira também

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext