ObOpenObjectByName (función)

Abre un objeto con validación y auditoría de acceso completo.

Sintaxis

NTSTATUS
ObOpenObjectByName (
    __in POBJECT_ATTRIBUTES ObjectAttributes,
    __in POBJECT_TYPE ObjectType,
    __in KPROCESSOR_MODE AccessMode,
    __inout_opt PACCESS_STATE AccessState,
    __in_opt ACCESS_MASK DesiredAccess,
    __inout_opt PVOID ParseContext,
    __out PHANDLE Handle
    )

Parámetros

ObjectAttributes [in]

Puntero a una estructura OBJECT_ATTRIBUTES que representa los atributos del objeto.

ObjectType [in]

El tipo de objeto. La estructura OBJECT_TYPE tiene la siguiente definición:

typedef struct _OBJECT_TYPE {
    LIST_ENTRY TypeList;
    UNICODE_STRING Name;            
    PVOID DefaultObject;
    UCHAR Index;
    __volatile ULONG TotalNumberOfObjects;
    __volatile ULONG TotalNumberOfHandles;
    ULONG HighWaterNumberOfObjects;
    ULONG HighWaterNumberOfHandles;
    OBJECT_TYPE_INITIALIZER TypeInfo;
    EX_PUSH_LOCK TypeLock;
    ULONG Key;
} OBJECT_TYPE, *POBJECT_TYPE;

AccessMode [in]

Modo de procesador del acceso. KPROCESSOR_MODE se define con los valores siguientes:

typedef enum _KPROCESSOR_MODE {
    KernelMode,
    UserMode,
    MaximumMode
} KPROCESSOR_MODE;

AccessState [in, out, optional]

Puntero opcional a una instancia de ACCESS_STATE que representa el estado de acceso actual que describe los tipos de acceso ya concedidos, los privilegios usados para obtenerlos y los tipos de acceso que aún se van a conceder.

DesiredAccess [in, optional]

Una instancia de ACCESS_MASK que representa el acceso deseado al objeto.

ParseContext [in, out, optional]

Puntero opcional para analizar los datos de contexto.

Handle [out]

Recibe el puntero a una variable que recibe el valor de identificador.

Valor devuelto

S_OK si es correcto.

Comentarios

Esta función no está definida en un encabezado del SDK y el autor de la llamada debe declararla. Esta función se exporta desde ntoskrnl.exe.

Requisitos

Consulte también