Función FsRtlInsertPerFileObjectContext (ntifs.h)

Para un controlador de filtro del sistema de archivos "heredado", la función FsRtlInsertPerFileObjectContext asocia información de contexto a un objeto de archivo.

Sintaxis

NTSTATUS FsRtlInsertPerFileObjectContext(
  [in] PFILE_OBJECT                  FileObject,
  [in] PFSRTL_PER_FILEOBJECT_CONTEXT Ptr
);

Parámetros

[in] FileObject

Puntero al objeto de archivo para el que se va a asociar información de contexto (dada por el parámetro Ptr).

[in] Ptr

Puntero a una estructura de FSRTL_PER_FILEOBJECT_CONTEXT asignada por el autor de la llamada e inicializada que se va a asociar a FileObject. La estructura se puede usar as-is o incrustarse en una estructura de información de contexto definida por el controlador por objeto. Para inicializar la estructura, use la macro FsRtlInitPerFileObjectContext.

Valor devuelto

FsRtlInsertPerFileObjectContext devuelve un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_SUCCESS	La estructura de información de contexto se ha asociado correctamente al objeto de archivo.
STATUS_INVALID_PARAMETER	El parámetro FileObject es NULL.
STATUS_INSUFFICIENT_RESOURCES	El sistema carece de recursos suficientes para completar la operación. Por ejemplo, no se pudo asignar una extensión de objeto de archivo para FileObject.

Observaciones

Un controlador de filtro del sistema de archivos llama a FsRtlInsertPerFileObjectContext para asociar su propia estructura de contexto por objeto de archivo con un objeto de archivo. La estructura de contexto contiene información de contexto que mantiene el controlador de filtro para el objeto de archivo. La función FsRtlInsertInsertPerStreamContext inserta la estructura de contexto de Ptr en la lista de contextos de FileObject.

Todas las estructuras de información de contexto por objeto de archivo deben ser o contener una estructura de FSRTL_PER_FILEOBJECT_CONTEXT inicializada. Use la macro FsRtlInitPerFileObjectContext para inicializar una estructura de FSRTL_PER_FILEOBJECT_CONTEXT.

Después de asociar una estructura de FSRTL_PER_FILEOBJECT_CONTEXT o estructura de contexto de objeto por archivo definida por filtro (que contiene una estructura de FSRTL_PER_FILEOBJECT_CONTEXT inicializada) a un objeto de archivo, se puede recuperar llamando a FsRtlLookupPerFileObjectContext o quitado llamando a FsRtlRemovePerFileObjectContext.

Nota Los controladores de minifiltro del sistema de archivos no deben usar las funciones deXxx FsRtlPerFileObjectContext. En su lugar, los minifiltros pueden usar las funciones FltXxxContext para asociar información de contexto a un objeto de archivo. Para obtener una lista completa, consulte el tema FSRTL_PER_FILEOBJECT_CONTEXT.

 

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
de la plataforma de destino de	Universal
encabezado de	ntifs.h (include Fltkernel.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL

Consulte también

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlLookupPerFileObjectContext

FsRtlRemovePerFileObjectContext