Función FsRtlLookupPerFileObjectContext (ntifs.h)

Para un controlador de filtro del sistema de archivos "heredado", la función FsRtlLookupPerFileObjectContext recupera información de contexto asociada previamente a un objeto de archivo.

Sintaxis

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

Parámetros

[in] FileObject

Puntero a un objeto de archivo para el que se va a consultar información de contexto.

[in, optional] OwnerId

Puntero a una variable asignada por el autor de la llamada que identifica de forma única el filtro propietario de la estructura de contexto por archivo-objeto. El formato de esta variable es específico del controlador de filtro.

[in, optional] InstanceId

Puntero a una variable asignada por el autor de la llamada que se puede usar para distinguir entre las estructuras de contexto por objeto de archivo creadas por el mismo controlador de filtro. El formato de esta variable es específico del controlador de filtro. Este parámetro es opcional y puede ser NULL.

Valor devuelto

FsRtlLookupPerFileObjectContext devuelve un puntero al primer contexto de objeto por archivo coincidente que se encuentra. Si no se encuentra ninguna coincidencia, FsRtlLookupPerFileObjectContext devuelve NULL.

Comentarios

Un controlador de filtro del sistema de archivos "heredado" llama a FsRtlLookupPerFileObjectContext para recuperar su estructura de contexto por objeto para un objeto de archivo. La estructura de contexto contiene información de contexto que mantiene el controlador de filtro para el objeto de archivo. Esta estructura de contexto debe haberse asociado previamente al objeto de archivo llamando a la función FsRtlInsertPerFileObjectContext .

Si la estructura de FSRTL_PER_FILEOBJECT_CONTEXT se inserta en una estructura de contexto definida por archivo y objeto de filtro, la macro CONTAINING_RECORD se puede usar para obtener un puntero al encabezado de la estructura definida por filtro.

Para inicializar una estructura de contexto por objeto de archivo, use la macro FsRtlInitPerFileObjectContext .

Para asociar una estructura de contexto por objeto por archivo inicializada con un objeto de archivo, use la función FsRtlInsertPerFileObjectContext .

Para quitar una estructura de contexto por objeto de archivo asociada a un objeto de archivo, use la función FsRtlRemovePerFileObjectContext .

Requisitos

Consulte también

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext