IX509PrivateKey::Export 方法 (certenroll.h)

Export 方法将私钥复制到字节数组。 字节数组由 Unicode 编码的字符串表示。

语法

HRESULT Export(
  [in]  BSTR         strExportType,
  [in]  EncodingType Encoding,
  [out] BSTR         *pstrEncodedKey
);

参数

[in] strExportType

一个 BSTR 值,该值指定私钥的导出方式。

如果密钥是使用 CNG KSP (密钥存储提供程序) 创建的,则可以在 NCryptExportKey 函数中指定 pszBlobType 参数允许的值之一。

如果密钥是使用 CryptoAPI CSP (加密服务提供程序) 创建的,则可以从 Wincrypt.h 随附的 Bcrypt.h 头文件中指定以下值之一。

Value 含义
BCRYPT_PUBLIC_KEY_BLOB
仅导出私钥的公共部分。
BCRYPT_PRIVATE_KEY_BLOB
导出整个私钥。

[in] Encoding

一个 EncodingType 枚举值,该值指定要应用于 pstrEncodedKey 参数中包含的字符串的 Unicode 编码的类型。 默认值为XCN_CRYPT_STRING_BASE64。

[out] pstrEncodedKey

指向包含私钥的 BSTR 变量的指针。

返回值

如果函数成功,该函数将返回 S_OK

如果函数失败,它将返回指示错误的 HRESULT 值。 可能的值包括(但并不限于)下表中的项。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

返回代码 说明
HRESULT_FROM_WIN32 (ERROR_CALL_NOT_IMPLEMENTED)
密钥由 CryptoAPI CSP 创建,你为 strExportType 参数指定了除 BCRYPT_PRIVATE_KEY_BLOB 或 BCRYPT_PUBLIC_KEY_BLOB 以外的值。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h
DLL CertEnroll.dll

另请参阅

IX509PrivateKey