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 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 serNULL si InstanceId no esNULL.

[in, optional] InstanceId

Puntero a una variable asignada por 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 FSRTL_PER_FILE_CONTEXT que coincide con el OwnerId de y InstanceId, si se especifica o NULL si no se encuentra ninguna coincidencia o el sistema de archivos no admite contextos por archivo.

Observaciones

Al no especificar OwnerID y 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

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_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

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