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 角色。 这可以是以下零个或多个值的按位组合。
返回代码/值 说明
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)
Library Certidl.lib
DLL Certadm.dll

另请参阅

ICertAdmin2