通过

iCertAdmin2：：SetConfigEntry 方法 (certadm.h)

  • 项目

SetConfigEntry 方法设置证书颁发机构 (CA) 的配置信息。

语法

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

参数

[in] strConfig

字符串值，表示 CA 的有效配置字符串，格式为 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是证书服务服务器的网络名称，CANAME 是 CA 的公用名，如证书服务设置过程中输入。 有关配置字符串名称的信息，请参阅 ICertConfig。 此参数可以是空字符串，在这种情况下，函数设置不特定于 CA 的配置信息。 此参数不能为 NULL。

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

[in] strNodePath

表示配置信息的节点路径的字符串值。 此参数可以是空字符串，在这种情况下，函数从 strConfig 标识的路径中检索配置信息。 此参数不能为 NULL。

[in] strEntryName

表示要设置其信息的条目的名称的字符串值。 此值可以是空字符串，在这种情况下，默认条目是正在设置的条目。 此参数不能为 NULL。

[in] pvarEntry

C++ 指向 VARIANT 的指针，指定要设置的信息。 如果此值为空，则将删除指示的键。
VB 指定要设置的信息的 Variant。 如果此值为空，则将删除指示的键。

返回值

VB

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

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

备注

配置信息存储在注册表中的以下路径下。

\ HKEY_LOCAL_MACHINE系统\CurrentControlSet\服务\CertSvc\配置\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

其中 CASANITIZEDNAME 是 CA 的 清理名称 。 有关已清理的名称的详细信息，请参阅 ICertConfig2：：GetConfig。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 certadm.h (包括 Certsrv.h)
Library Certidl.lib
DLL Certadm.dll

另请参阅

ICertAdmin2