CryptImportPublicKeyInfo 函数 (wincrypt.h)

  • 项目
重要 此 API 已弃用。 新的和现有的软件应开始使用 加密下一代 API。 Microsoft 可能会在将来的版本中删除此 API。
 
CryptImportPublicKeyInfo 函数将公钥信息转换并导入提供程序，并返回公钥的句柄。 CryptImportPublicKeyInfoEx 提供了此函数的修订版本。

语法

BOOL CryptImportPublicKeyInfo(
  [in]  HCRYPTPROV            hCryptProv,
  [in]  DWORD                 dwCertEncodingType,
  [in]  PCERT_PUBLIC_KEY_INFO pInfo,
  [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 结构的地址。

[out] phKey

接收导入公钥句柄的 HCRYPTKEY 变量的地址。 使用完公钥后，通过调用 CryptDestroyKey 函数释放句柄。

返回值

如果函数成功，则返回值为非零 (TRUE) 。

如果函数失败，则返回值为零， (FALSE) 。 有关扩展的错误信息，请调用 GetLastError。

注意 调用函数 CryptGetUserKey 和 CryptExportKey 的错误可能会传播到此函数。 此函数具有以下错误代码。
 
返回代码 说明
ERROR_FILE_NOT_FOUND
 找不到指定 dwCertEncodingType 和 pInfo-Algorithm.pszObjId> 参数可以安装或注册的导入函数。
 

如果函数失败， 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

另请参阅

CryptExportPublicKeyInfo

数据管理函数