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 角色。 這可以是零個或多個下列值的位元組合。
傳回值
C++
如果函式成功，傳回值會S_OK。如果函式失敗，傳回值就是 指出錯誤的 HRESULT 。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。
VB
傳回值是 Long 值，代表呼叫端所擷取的 CA 角色。 這可以是零個或多個下列值的位元組合。| 傳回碼/值 | Description |
|---|---|
|
呼叫端具有 CA 系統管理員功能。 |
|
呼叫端具有 CA 稽核員功能。 |
|
呼叫端具有註冊存取權。 |
|
呼叫端具有 CA 人員功能。 |
|
呼叫端具有 CA 備份功能。 |
|
呼叫端具有讀取權限。 |
規格需求
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | certadm.h (包含 Certsrv.h) |
| 程式庫 | Certidl.lib |
| Dll | Certadm.dll |