Compartilhar via

Função FsRtlInsertPerFileContext (ntifs.h)

  • Artigo

A rotina FsRtlInsertPerFileContext associa um objeto FSRTL_PER_FILE_CONTEXT a um objeto de contexto especificado pelo driver para um arquivo.

Sintaxe

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

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] Ptr

Um ponteiro para a estrutura de contexto específica do driver.

Valor de retorno

A rotina FsRtlInsertPerFileContext retorna STATUS_SUCCESS ou um código de erro apropriado, como:

Código de retorno Descrição
STATUS_INVALID_DEVICE_REQUEST
 O sistema de arquivos subjacente não dá suporte a contextos de arquivo de filtro. Você pode usar a macro FsRtlSupportsPerFileContexts para verificar se um sistema de arquivos é compatível com objetos de contexto de arquivo.
STATUS_INSUFFICIENT_RESOURCES
 O sistema não pôde alocar recursos (normalmente memória).

Observações

A macro FsRtlGetPerFileContextPointer retorna um FileContextSupportPointer para um arquivo aberto.

Parâmetros

FileObject

FILE_OBJECT

Um ponteiro para um objeto de arquivo.

Valor de retorno

PVOID

A macro FsRtlGetPerFileContextPointer retorna um ponteiro opaco usado pelo pacote FSRTL (biblioteca de runtime do sistema de arquivos) para acompanhar contextos de arquivo. A macro retornará NULL se o sistema de arquivos não oferecer suporte ao uso de objetos de contexto por arquivo com arquivos.

A macro FsRtlGetPerFileContextPointer retorna o ponteiro a ser passado para rotinas como FsRtlInsertPerFileContext, FsRtlLookupPerFileContexte FsRtlRemovePerFileContext.

Para obter mais informações sobre como usar e criar objetos de contexto, consulte acompanhamento Per-File contexto em um driver de filtro do sistema de arquivos herdado.

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

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

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