Função FsRtlLookupPerFileContext (ntifs.h)

A rotina FsRtlLookupPerFileContext retorna um ponteiro para um objeto FSRTL_PER_FILE_CONTEXT associado a um arquivo especificado.

Sintaxe

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

Parâmetros

[in] PerFileContextPointer

Um ponteiro para um ponteiro opaco usado pelo pacote FSRTL (biblioteca de runtime do sistema de arquivos) para acompanhar contextos de arquivo. Para recuperar esse ponteiro de um objeto de arquivo, use a macro FsRtlGetPerFileContextPointer .

[in, optional] OwnerId

Um ponteiro para uma variável alocada pelo driver de filtro que identifica exclusivamente o proprietário da estrutura de contexto por arquivo. O formato dessa variável é específico do driver de filtro. Esse parâmetro é opcional, mas deve ser não NULL se InstanceId não for NULL.

[in, optional] InstanceId

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

Retornar valor

Um ponteiro para a primeira estrutura FSRTL_PER_FILE_CONTEXT que corresponde a OwnerId e InstanceId, se especificado, ou NULL se nenhuma correspondência for encontrada ou se o sistema de arquivos não oferecer suporte a contextos por arquivo.

Comentários

Ao não especificar OwnerID e InstanceId, um driver de filtro pode pesquisar o primeiro contexto associado a um arquivo.

Se o sistema de arquivos não der suporte a objetos de contexto por arquivo, NULL será retornado. Use a macro FsRtlSupportsPerFileContexts para determinar se um sistema de arquivos dá suporte a objetos de contexto por arquivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua FltKernel.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

Acompanhamento Per-File contexto em um driver de filtro do sistema de arquivos herdado