CryptImportPublicKeyInfoEx 函数 (wincrypt.h)
语法
BOOL CryptImportPublicKeyInfoEx(
[in] HCRYPTPROV hCryptProv,
[in] DWORD dwCertEncodingType,
[in] PCERT_PUBLIC_KEY_INFO pInfo,
[in] ALG_ID aiKeyAlg,
[in] DWORD dwFlags,
[in] void *pvAuxInfo,
[out] HCRYPTKEY *phKey
);
参数
[in] hCryptProv
用于接收导入公钥的 CSP 的句柄。 此句柄必须已使用 CryptAcquireContext 创建。
[in] dwCertEncodingType
指定使用的编码类型。 始终可以接受将证书和 消息编码类型 与按位 OR 操作组合在一起,如以下示例所示:
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING
当前定义的编码类型包括:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
[in] pInfo
包含要导入到提供程序中的公钥 的CERT_PUBLIC_KEY_INFO 结构的地址。
[in] aiKeyAlg
一个ALG_ID结构,其中包含用于替代CALG_RSA_KEYX默认算法的特定于 CSP 的算法。
[in] dwFlags
保留以供将来使用,必须为零。
[in] pvAuxInfo
保留以供将来使用,必须为 NULL。
[out] phKey
接收导入公钥句柄的 HCRYPTKEY 变量的地址。 使用完公钥后,通过调用 CryptDestroyKey 函数释放句柄。
返回值
如果函数成功,则函数) 返回非零 (TRUE 。
如果函数失败,它将返回零 (FALSE) 。 有关扩展的错误信息,请调用 GetLastError。
值 | 说明 |
---|---|
|
找不到可安装或注册的指定 dwCertEncodingType 和 pInfo 参数的导入函数。 |
如果函数失败, GetLastError 可能会返回 抽象语法表示法 One (ASN.1) 编码/解码错误。 有关这些错误的信息,请参阅 ASN.1 编码/解码返回值。
注解
此函数通常用于从证书中检索公钥。 这是通过从填充证书结构传递 CERT_PUBLIC_KEY_INFO 结构来完成的,如以下伪代码所示。
PCCERT_CONTEXT pCertContext
// Get the certificate context structure from a certificate.
pCertContext = CertCreateCertificateContext(...)
if(pCertContext)
{
HCRYPTKEY hCertPubKey
// Get the public key information for the certificate.
CryptImportPublicKeyInfo(
hCryptProv,
X509_ASN_ENCODING,
&pCertContext->pCertInfo->SubjectPublicKeyInfo,
&hCertPubKey)
CertFreeCertificateContext(pCertContext)
}
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | wincrypt.h |
Library | Crypt32.lib |
DLL | Crypt32.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈