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
Acompanhamento Per-File contexto em um driver de filtro do sistema de arquivos herdado