通过

ICertAdmin2：：SetCAProperty 方法（certadm.h）

  • 项目

SetCAProperty 方法为 证书颁发机构（CA）设置属性值。

语法

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

参数

[in] strConfig

字符串值，表示 CA 的有效配置字符串，格式为 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是证书服务服务器的网络名称，CANAME 是 CA 的公用名，在证书服务设置过程中输入。 有关配置字符串名称的信息，请参阅 ICertConfig。

重要SetCAProperty 在配置字符串更改时不会清除内部缓存。 更改 CA 的配置字符串时，必须实例化新的 ICertAdmin 对象，并使用新的配置字符串再次调用此方法。

 

[in] PropId

指定以下属性标识符之一。

有关所有 CA 属性（包括只读属性）的信息，请参阅 ICertAdmin2：：GetCAProperty。

价值 意义
CR_PROP_KRACERT
 CA 的密钥恢复代理 （KRA） 证书。

数据格式：二进制，已编制索引。
CR_PROP_KRACERTCOUNT
 CA 的 KRA 证书数。

数据格式：Long。
CR_PROP_KRACERTUSEDCOUNT
 CA 使用的 KRA 证书数。

数据格式：Long。
CR_PROP_ROLESEPARATIONENABLED
 指定是否启用角色分离的值。

数据格式：Long。
CR_PROP_TEMPLATES
 CA 支持的模板列表。

数据格式：字符串。

[in] PropIndex

如果为 PropId 参数编制索引，则检索属性值时要使用的从零开始的索引。 如果未为 PropId 编制索引，则忽略此值。

[in] PropType

指定属性的类型。 此参数可以是下列值之一。

价值 意义
PROPTYPE_LONG
 已签名 长 数据。
PROPTYPE_DATE
 日期/时间（保留供将来使用）。
PROPTYPE_BINARY
 二进制数据。
PROPTYPE_STRING
 Unicode字符串 数据。

[in] pvarPropertyValue

C++ 指向指定属性值的 VARIANT 的指针。
VB 指定属性值的 Variant。

返回值

VB

如果函数成功，则返回值S_OK。

如果函数失败，则返回值为指示错误的 HRESULT。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。

要求

要求 价值
最低支持的客户端 不支持
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 certadm.h （包括 Certsrv.h）
库 Certidl.lib
DLL Certadm.dll

另请参阅

ICertAdmin2

ICertAdmin2：：GetCAProperty