Función FsRtlLookupPerFileContext (ntifs.h)

La rutina FsRtlLookupPerFileContext devuelve un puntero a un objeto FSRTL_PER_FILE_CONTEXT asociado a un archivo especificado.

Sintaxis

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

Parámetros

[in] PerFileContextPointer

Puntero a un puntero opaco que usa el paquete de la biblioteca en tiempo de ejecución del sistema de archivos (FSRTL) para realizar un seguimiento de los contextos de archivo. Para recuperar este puntero de un objeto de archivo, use la macro FsRtlGetPerFileContextPointer .

[in, optional] OwnerId

Puntero a una variable asignada por el controlador de filtro que identifica de forma única el propietario de la estructura de contexto por archivo. El formato de esta variable es específico del controlador de filtro. Este parámetro es opcional, pero debe ser distinto de NULL si InstanceId no es NULL.

[in, optional] InstanceId

Puntero a una variable asignada por el controlador de filtro que se puede usar para distinguir entre las estructuras de contexto por 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.

Valor devuelto

Puntero a la primera estructura de FSRTL_PER_FILE_CONTEXT que coincide con ownerId e InstanceId, si se especifica o NULL si no se encuentra ninguna coincidencia o el sistema de archivos no admite contextos por archivo.

Comentarios

Al no especificar OwnerID e InstanceId, un controlador de filtro puede buscar el primer contexto asociado a un archivo.

Si el sistema de archivos no admite objetos de contexto por archivo, se devuelve NULL . Use la macro FsRtlSupportsPerFileContexts para determinar si un sistema de archivos admite objetos de contexto por archivo.

Requisitos

Consulte también

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

Seguimiento Per-File contexto en un controlador de filtro del sistema de archivos heredado