共用方式為


ICertAdmin2::GetMyRoles 方法 (certadm.h)

GetMyRoles方法會擷取憑證授權單位單位 (CA) 呼叫者的角色。

語法

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

參數

[in] strConfig

字串值,代表 CA 的有效組態字串,格式為 COMPUTERNAME\CANAME,其中 COMPUTERNAME 是憑證服務伺服器的網路名稱,而 CANAME 是 CA 的一般名稱,如憑證服務設定期間輸入。 如需組態字串名稱的相關資訊,請參閱 ICertConfig

重要GetMyRoles 不會在設定字串變更時清除內部快取。 當您變更 CA 的組態字串時,您必須具現化新的 ICertAdmin 物件,並使用新的組態字串再次呼叫此方法。
 

[out] pRoles

LONG值的指標,表示呼叫端所擷取的 CA 角色。 這可以是零個或多個下列值的位元組合。

意義
CA_ACCESS_ADMIN
0x1
呼叫端具有 CA 系統管理員功能。
CA_ACCESS_AUDITOR
0x4
呼叫端具有 CA 稽核員功能。
CA_ACCESS_ENROLL
0x200
呼叫端具有註冊存取權。
CA_ACCESS_OFFICER
0x2
呼叫端具有 CA 人員功能。
CA_ACCESS_OPERATOR
0x8
呼叫端具有 CA 備份功能。
CA_ACCESS_READ
0x100
呼叫端具有 CA 讀取權限。

傳回值

C++

如果函式成功,傳回值會S_OK。

如果函式失敗,傳回值就是 指出錯誤的 HRESULT 。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值

VB

傳回值是 Long 值,代表呼叫端所擷取的 CA 角色。 這可以是零個或多個下列值的位元組合。
傳回碼/值 Description
CA_ACCESS_ADMIN
0x1
呼叫端具有 CA 系統管理員功能。
CA_ACCESS_AUDITOR
0x4
呼叫端具有 CA 稽核員功能。
CA_ACCESS_ENROLL
0x200
呼叫端具有註冊存取權。
CA_ACCESS_OFFICER
0x2
呼叫端具有 CA 人員功能。
CA_ACCESS_OPERATOR
0x8
呼叫端具有 CA 備份功能。
CA_ACCESS_READ
0x100
呼叫端具有讀取權限。

規格需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 certadm.h (包含 Certsrv.h)
程式庫 Certidl.lib
Dll Certadm.dll

另請參閱

ICertAdmin2