CryptExportPKCS8Ex 函数 (wincrypt.h)
[从 Windows Server 2008 和 Windows Vista 起, CryptExportPKCS8Ex 函数不再可供使用。 请改用 PFXExportCertStoreEx 函数。]
CryptExportPKCS8Ex 函数以 PKCS #8 格式导出私钥。此函数没有关联的导入库。 必须使用 LoadLibrary 和 GetProcAddress 函数动态链接到 Crypt32.dll。
语法
BOOL CryptExportPKCS8Ex(
[in] CRYPT_PKCS8_EXPORT_PARAMS *psExportParams,
[in] DWORD dwFlags,
[in, optional] void *pvAuxInfo,
[out, optional] BYTE *pbPrivateKeyBlob,
[in, out] DWORD *pcbPrivateKeyBlob
);
参数
[in] psExportParams
指向 CRYPT_PKCS8_EXPORT_PARAMS 结构的指针,该结构包含有关要导出的密钥的信息。
[in] dwFlags
如果 pbPrivateKeyBlob 为 NULL ,则此参数应为零,否则0x8000。
[in, optional] pvAuxInfo
此参数必须为 NULL。
[out, optional] pbPrivateKeyBlob
指向 BYTE 结构的数组的指针,用于接收要导出的私钥。
私钥将包含 PKCS #8 PrivateKeyInfo 抽象语法表示法 One (ASN.1) 在 PKCS #8 标准中找到的类型中的信息。
出于内存分配目的,可以通过将此参数设置为 NULL 来获取要导出的私钥的大小。 有关详细信息,请参阅 检索长度未知的数据。
[in, out] pcbPrivateKeyBlob
指向 DWORD 的指针,在输入时可能包含包含 pbPrivateKeyBlob 所需的内存分配的大小(以字节为单位)。 如果 pbPrivateKeyBlob 为 NULL,此参数将返回第二次调用函数所需的内存分配大小。 有关详细信息,请参阅 检索长度未知的数据。
返回值
如果函数成功,则函数) 返回非零 (TRUE 。
如果函数失败,则返回零 (FALSE) 。 有关扩展的错误信息,请调用 GetLastError。
以下错误代码特定于此函数。
返回代码 | 说明 |
---|---|
|
找不到可以安装或注册的导出函数。 |
|
如果 pbPrivateKeyBlob 参数指定的缓冲区不够大,无法保存返回的数据,则函数将设置ERROR_MORE_DATA代码,并将所需的缓冲区大小(以字节为单位)存储在 由KeyBlob 参数指向的变量中。 |
如果函数失败, GetLastError 将返回 ASN.1 编码/解码错误。 有关这些错误的信息,请参阅 ASN.1 编码/解码返回值。
注解
仅非对称密钥支持此函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | wincrypt.h |
DLL | Crypt32.dll |