iCertAdmin2::ImportKey 方法 (certadm.h)

ImportKey 方法将加密密钥集添加到证书服务数据库中的项。 将密钥集加密为一个或多个密钥恢复代理, (KRA) 证书。

语法

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

参数

[in] strConfig

字符串值,表示 证书颁发机构 (CA) 的有效配置字符串,格式为 COMPUTERNAME\CANAME,其中 COMPUTERNAME 是证书服务服务器的网络名称,CANAME 是 CA 的公用名,如证书服务设置过程中输入的那样。 有关配置字符串名称的信息,请参阅 ICertConfig

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

[in] RequestId

LONG 值,表示证书服务数据库中的证书 请求 ID。 如果要使用 (作为 strCertHash) 传入的序列号而不是请求 ID,则对此值使用零。

[in] strCertHash

表示证书哈希的字符串值。 若要使用 strCertHash ,必须将 RequestId 的值指定为零。

[in] Flags

指定密钥的格式。 此参数的取值可为下列值之一:

含义
CR_IN_BASE64HEADER
BASE64 格式,开头或结尾。
CR_IN_BASE64
不带开头或结尾的 BASE64 格式。
CR_IN_BINARY
二进制格式。
 

此外,可以使用按位 OR 运算将以下值与格式值组合在一起。

含义
IKF_OVERWRITE
将覆盖任何现有的 KRA 编码信息。

[in] strKey

表示 KRA 键信息的字符串值。

返回值

要求

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

另请参阅

ICertAdmin2