ICEnroll4：：createPFX 方法 (xenroll.h)

  • 项目

[此方法在 Windows Server 2008 和 Windows Vista 中不再可用。]

createPFX 方法将接受的证书链和私钥保存在个人信息交换 (PFX) 格式字符串中。 PFX 格式也称为 PKCS #12。

此方法首先在 ICEnroll4 接口中定义。

语法

HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

参数

[in] strPassword

PFX 格式消息的密码。 此值可以为空或 NULL ，表示未使用任何密码。 使用完密码后，通过调用 SecureZeroMemory 函数从内存中清除密码。 有关保护密码的详细信息，请参阅 处理密码。

[out] pstrPFX

指向接收 base64 编码 PFX 格式证书信息的 BSTR 的指针。 使用完 BSTR 后，通过调用 SysFreeString 函数来释放它。

返回值

C++

如果方法成功，该方法将返回S_OK。

如果方法失败，它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

VB

返回值为包含 PFX 格式证书信息的 字符串 。

注解

将证书注册控件作为脚本控件执行时，将禁用此方法。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 xenroll.h
Library Uuid.lib
DLL Xenroll.dll