Função FsRtlRemovePerFileObjectContext (ntifs.h)

Para um driver de filtro do sistema de arquivos "herdado", a função FsRtlRemovePerFileObjectContext desvincula uma estrutura de informações de contexto por arquivo-objeto da lista de contextos por arquivo-objeto anteriormente associados a um objeto de arquivo.

Sintaxe

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlRemovePerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

Parâmetros

[in] FileObject

Um ponteiro para um objeto de arquivo para o qual remover informações de contexto.

[in, optional] OwnerId

Um ponteiro para uma variável alocada por chamador que identifica exclusivamente o filtro proprietário da estrutura de contexto por objeto de arquivo. O formato dessa variável é específico do driver de filtro.

[in, optional] InstanceId

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

Valor de retorno

FsRtlRemovePerFileObjectContext desvincula e retorna um ponteiro para o primeiro contexto correspondente por arquivo-objeto encontrado. Se nenhuma correspondência for encontrada, FsRtlRemovePerFileObjectContext retornará NULL.

Observações

Um driver de filtro de sistema de arquivos "herdado" chama FsRtlRemovePerFileObjectContext para desvincular sua própria estrutura de contexto por arquivo-objeto da lista de contextos por arquivo-objeto associados ao objeto de arquivo. Todas essas estruturas de contexto devem ter sido associadas anteriormente ao objeto de arquivo chamando FsRtlInsertPerFileObjectContext.

Se a chamada para FsRtlRemovePerFileObjectContext for bem-sucedida, a primeira estrutura de contexto por objeto por arquivo correspondente OwnerId (e InstanceId, se presente) será desvinculada e um ponteiro para ele retornado. Esse ponteiro pode ser usado pelo driver de filtro para liberar a estrutura de contexto desvinculada.

ObservaçãoFsRtlRemovePerFileObjectContext desvincula apenas a primeira estrutura de contexto de objeto por arquivo correspondente encontrada. Se houver contextos correspondentes adicionais por arquivo-objeto, o driver de filtro deverá chamar FsRtlRemovePerFileObjectContext quantas vezes forem necessárias para desvincular todos eles.

 

Para inicializar uma estrutura de contexto por arquivo-objeto, use a macro FsRtlInitPerFileObjectContext.

Para associar uma estrutura de contexto por arquivo-objeto inicializada a um objeto de arquivo, use a função FsRtlInsertPerFileObjectContext.

Para recuperar uma estrutura de contexto por arquivo-objeto associada a um objeto de arquivo, use a função FsRtlLookupPerFileObjectContext.

Observação Drivers de filtro herdados devem chamar a função FsRtlRemovePerFileObjectContext para desvincular e liberar a estrutura de informações de contexto antes da conclusão do IRP_MJ_CLOSE. Caso contrário, a memória alocada para essa estrutura de contexto será vazada.

 

Além disso, os drivers de minifiltro do sistema de arquivos não devem usar as funções FsRtlXxxPerFileObjectContext. Em vez disso, eles podem usar as funções de Contexto xxxapropriadas. Para obter informações adicionais, consulte o tópico FSRTL_PER_FILEOBJECT_CONTEXT.

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_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlLookupPerFileObjectContext