Função FsRtlInsertPerFileContext (ntifs.h)

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.

Retornar valor

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 marcar se um sistema de arquivos dá suporte a objetos de contexto de arquivo.
STATUS_INSUFFICIENT_RESOURCES	O sistema não pôde alocar recursos (normalmente memória).

Comentários

A macro FsRtlGetPerFileContextPointer retorna um FileContextSupportPointer para um arquivo aberto.

Parâmetros

FileObject

FILE_OBJECT

Um ponteiro para um objeto de arquivo.

Retornar valor

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 der suporte ao uso de objetos de contexto por arquivo com arquivos.

A macro FsRtlGetPerFileContextPointer retorna o ponteiro a ser passado para rotinas como FsRtlInsertPerFileContext, FsRtlLookupPerFileContext e 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
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

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

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