Funzione ObOpenObjectByName

Apre un oggetto con convalida e controllo di accesso completo.

Sintassi

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
    )

Parametri

ObjectAttributes [in]

Puntatore a una struttura OBJECT_ATTRIBUTES che rappresenta gli attributi dell'oggetto.

ObjectType [in]

Tipo dell'oggetto. La struttura OBJECT_TYPE ha la definizione seguente:

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]

Modalità processore dell'accesso. Il KPROCESSOR_MODE viene definito con i valori seguenti:

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

AccessState [in, out, facoltativo]

Puntatore facoltativo a un ACCESS_STATE che rappresenta lo stato di accesso corrente che descrive i tipi di accesso già concessi, i privilegi usati per ottenerli e tutti i tipi di accesso ancora da concedere.

DesiredAccess [in, facoltativo]

Oggetto ACCESS_MASK che rappresenta l'accesso desiderato all'oggetto .

ParseContext [in, out, optional]

Puntatore facoltativo per analizzare i dati del contesto.

Handle [out]

Riceve il puntatore a una variabile che riceve il valore dell'handle.

Valore restituito

S_OK al successo.

Osservazioni:

Questa funzione non è definita in un'intestazione SDK e deve essere dichiarata dal chiamante. Questa funzione viene esportata da ntoskrnl.exe.

Requisiti

Vedi anche