Función ObOpenObjectByPointer (ntifs.h)

La función ObOpenObjectByPointer abre un objeto al que hace referencia un puntero y devuelve un identificador al objeto .

Sintaxis

NTSTATUS ObOpenObjectByPointer(
  [in]           PVOID           Object,
  [in]           ULONG           HandleAttributes,
  [in, optional] PACCESS_STATE   PassedAccessState,
  [in]           ACCESS_MASK     DesiredAccess,
  [in, optional] POBJECT_TYPE    ObjectType,
  [in]           KPROCESSOR_MODE AccessMode,
  [out]          PHANDLE         Handle
);

Parámetros

[in] Object

Puntero al objeto que se va a abrir.

[in] HandleAttributes

Máscara de bits de marcas que especifican los atributos deseados para el identificador de objeto. Si el autor de la llamada no se está ejecutando en el contexto del proceso del sistema, estas marcas deben incluir OBJ_KERNEL_HANDLE. Este parámetro es opcional y puede ser cero. De lo contrario, es una combinación OR'ed de uno o varios de los valores siguientes.

[in, optional] PassedAccessState

Puntero a una estructura de ACCESS_STATE que contiene el contexto del sujeto del objeto, los tipos de acceso concedidos y los tipos de acceso deseados restantes. Este parámetro es opcional y puede ser NULL. En una rutina de envío de creación, este puntero se puede encontrar en IrpSp->Parameters.Create.SecurityContext->AccessState, donde irpSp es un puntero a la propia ubicación de pila del autor de la llamada en IRP. (Para obtener más información, vea IRP_MJ_CREATE).

[in] DesiredAccess

ACCESS_MASK valor que especifica el acceso deseado al objeto. Este parámetro es opcional y puede ser cero.

[in, optional] ObjectType

Puntero al tipo de objeto. Si el valor de AccessMode es KernelMode, este parámetro es opcional y puede ser NULL. De lo contrario, debe ser *ExEventObjectType , *ExSemaphoreObjectType, *IoFileObjectType, *PsThreadType, *SeTokenObjectTypeo *CmKeyObjectType.

[in] AccessMode

Modo de acceso que se usará para la comprobación de acceso. Este parámetro es necesario y debe ser UserMode o KernelMode:

• Si AccessMode es KernelMode, el sistema siempre permite el acceso solicitado independientemente de cualquier acceso restringido establecido previamente un controlador (por ejemplo, acceso restringido en una llamada anterior a POB_PRE_OPERATION_CALLBACK devolución de llamada).

• Si AccessMode es userMode, el acceso solicitado se compara con el acceso concedido para el objeto.

[out] Handle

Puntero a una variable asignada por el autor de la llamada que recibe un identificador del objeto .

Valor devuelto

ObOpenObjectByPointer devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Observaciones

Si el parámetro Object apunta a un objeto de archivo (es decir, una estructura de FILE_OBJECT), ObOpenObjectByPointer solo se puede llamar después de crear al menos un identificador para el objeto de archivo. Los autores de llamadas pueden comprobar el miembro marcas de de la estructura de FILE_OBJECT a la que apunta el parámetro Object. Si se establece la marca FO_HANDLE_CREATED, esto significa que se han creado uno o varios identificadores para el objeto de archivo, por lo que es seguro llamar a ObOpenObjectByPointer.

Cualquier identificador obtenido mediante una llamada a obOpenObjectByPointer debe liberarse llamando a ZwClose.

Las rutinas de controlador que se ejecutan en un contexto de proceso distinto del del proceso del sistema deben establecer la marca OBJ_KERNEL_HANDLE en el parámetro HandleAttributes. Esto restringe el uso del identificador devuelto por ObOpenObjectByPointer a los procesos que se ejecutan en modo kernel. De lo contrario, el proceso puede acceder al identificador en cuyo contexto se está ejecutando el controlador.

Requisitos

Consulte también

ACCESS_MASK

ACCESS_STATE

IRP_MJ_CREATE

ObReferenceObject de

obReferenceObjectByHandle

obReferenceObjectByPointer

ZwClose