共用方式為

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 的錯誤可能會傳播至此函式。 此函式具有下列錯誤碼。
 
傳回碼 Description
ERROR_FILE_NOT_FOUND
 找不到指定 dwCertEncodingType 和 pInfo-Algorithm.pszObjId> 參數的匯入函式。
 

如果函式失敗， GetLastError 可能會傳回 抽象語法表示法一 (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
程式庫 Crypt32.lib
Dll Crypt32.dll

另請參閱

CryptExportPublicKeyInfo

資料管理 函式