CryptImportPublicKeyInfo 函式 (wincrypt.h)

語法

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。

如果函式失敗， 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)
}

規格需求

另請參閱

CryptExportPublicKeyInfo

資料管理 函式