ObOpenObjectByName 函式

開啟具有完整存取權驗證和稽核的物件。

語法

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
    )

參數

ObjectAttributes [in]

代表物件屬性之 OBJECT_ATTRIBUTES結構的指標 。

ObjectType [in]

物件類型。 OBJECT_TYPE 結構具有下列定義：

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]

存取的處理器模式。 KPROCESSOR_MODE 是以下列值定義：

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

AccessState [in， out， optional]

ACCESS_STATE的選擇性指標 ，代表目前存取狀態，描述已授與存取類型、用來取得這些類型的許可權，以及尚未授與的任何存取類型。

DesiredAccess [in， 選擇性]

表示 物件所需存取權的ACCESS_MASK 。

ParseCoNtext [in， out， optional]

用來剖析內容資料的選擇性指標。

處理 [out]

接收接收控制碼值的變數指標。

傳回值

成功S_OK。

備註

此函式未定義于 SDK 標頭中，而且必須由呼叫端宣告。 此函式會從 ntoskrnl.exe 匯出。

需求

另請參閱