Função FsRtlLookupPerFileContext (ntifs.h)
A rotina FsRtlLookupPerFileContext
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
[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 NULL não
[in, optional] InstanceId
Um ponteiro para uma variável alocada pelo driver de filtro que pode ser usada para distinguir entre as estruturas de contexto por arquivo que são criadas pelo mesmo driver de filtro. O formato dessa variável é específico do driver de filtro. Esse parâmetro é opcional.
Valor de retorno
Um ponteiro para a primeira estrutura FSRTL_PER_FILE_CONTEXT que corresponde ao 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.
Observações
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 |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino |
Universal |
| cabeçalho | ntifs.h (inclua FltKernel.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL |
NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Consulte também
controle Per-File contexto em um driver de filtro do sistema de arquivos herdado