CryptImportPublicKeyInfoEx 函式 (wincrypt.h)
重要 此 API 已被取代。 新的和現有的軟體應該開始使用 密碼編譯新一代 API。 Microsoft 可能會在未來的版本中移除此 API。
語法
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 結構位址。
注意pInfo和dwCertEncodingType參數所指向之 Algorithm成員的pzObjId成員會決定可安裝CRYPT_OID_IMPORT_PUBLIC_KEY_INFO_FUNC回呼函式。 如果找不到可安裝的函式，則會嘗試將金鑰匯入為 RSA 公開金鑰 (szOID_RSA_RSA) 。
[in] aiKeyAlg
包含 CSP 特定演算法的 ALG_ID 結構，可覆寫 CALG_RSA_KEYX 預設演算法。
[in] dwFlags
保留供日後使用，且必須為零。
[in] pvAuxInfo
保留供日後使用，且必須是 Null。
[out] phKey
接收匯入公開金鑰控制碼的 HCRYPTKEY 變數位址。 當您完成使用公開金鑰時，請呼叫 CryptDestroyKey 函式來釋放控制碼。
傳回值
如果函式成功，函式會傳回非零 (TRUE) 。
如果函式失敗，它會傳回零 (FALSE) 。 如需擴充錯誤資訊，請呼叫 GetLastError。
注意 來自所呼叫函式 CryptGetUserKey 和 CryptExportKey 的錯誤可能會傳播至此函式。 此函式具有下列錯誤碼。
| 值 | 描述 |
|---|---|
|
找不到指定的 dwCertEncodingType 和 pInfo 參數無法安裝或註冊的匯入函式。 |
如果函式失敗， 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 |