ObOpenObjectByName-Funktion

Öffnet ein Objekt mit Vollzugriffsüberprüfung und Überwachung.

Syntax

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
    )

Parameter

ObjectAttributes [in]

Ein Zeiger auf eine OBJECT_ATTRIBUTES-Struktur, die die Objektattribute darstellt.

ObjectType [in]

Der Objekttyp. Die OBJECT_TYPE-Struktur weist die folgende Definition auf:

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]

Der Prozessormodus des Zugriffs. KPROCESSOR_MODE wird mit den folgenden Werten definiert:

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

AccessState [in, out, optional]

Ein optionaler Zeiger auf einen ACCESS_STATE, der den aktuellen Zugriffsstatus mit einer Beschreibung der bereits gewährten Zugriffstypen, der zum Abrufen dieser Typen verwendeten Berechtigungen und aller noch zu erteilenden Zugriffstypen darstellt.

DesiredAccess [in, optional]

Eine ACCESS_MASK, die den gewünschten Zugriff auf das Objekt darstellt.

ParseContext [in, out, optional]

Ein optionaler Zeiger zum Analysieren von Kontextdaten.

Handle [out]

Empfängt einen Zeiger auf eine Variable, die den Handlewert empfängt.

Rückgabewert

S_OK bei Erfolg.

Hinweise

Diese Funktion ist nicht in einem SDK-Header definiert und muss vom Aufrufer deklariert werden. Diese Funktion wird von „ntoskrnl.exe“ exportiert.

Anforderungen

Weitere Informationen