CryptExportPublicKeyInfoEx 函式 (wincrypt.h)

  • 發行項

CryptExportPublicKeyInfoEx 函式會匯出與提供者對應私鑰相關聯的公鑰資訊。 此函式可讓應用程式指定 公鑰演演算法，覆寫 密碼編譯服務提供者 所提供的預設值， (CSP) 。

語法

BOOL CryptExportPublicKeyInfoEx(
  [in]      HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hCryptProvOrNCryptKey,
  [in]      DWORD                           dwKeySpec,
  [in]      DWORD                           dwCertEncodingType,
  [in]      LPSTR                           pszPublicKeyObjId,
  [in]      DWORD                           dwFlags,
  [in]      void                            *pvAuxInfo,
  [out]     PCERT_PUBLIC_KEY_INFO           pInfo,
  [in, out] DWORD                           *pcbInfo
);

參數

[in] hCryptProvOrNCryptKey

匯出公鑰資訊時要使用的 CSP 句柄。 此句柄必須是使用 CryptAcquireContext 函式所建立的 HCRYPTPROV 句柄，或是使用 NCryptOpenKey 函式所建立的NCRYPT_KEY_HANDLE句柄。 新的應用程式應該一律傳入 CNG CSP NCRYPT_KEY_HANDLE 句柄。

[in] dwKeySpec

識別要從提供者容器使用的 私鑰 。 它可以AT_KEYEXCHANGE或AT_SIGNATURE。 如果在 hCryptProvOrNCryptKey 參數中使用NCRYPT_KEY_HANDLE，則會忽略此參數。

[in] dwCertEncodingType

指定所使用的編碼類型。 將憑證和 訊息編碼類型 與位 OR 作業結合在一起，一律可以接受，如下列範例所示：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

目前定義的編碼類型如下：

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pszPublicKeyObjId

指定公鑰演演算法。

注意pszPublicKeyObjId 和 dwCertEncodingType 會一起使用，以判斷要呼叫 的 可安裝CRYPT_OID_EXPORT_PUBLIC_KEY_INFO_FUNC。 如果找不到 pszPublicKeyObjId 參數的可安裝函式，則會嘗試將密鑰導出為 RSA 公鑰 (szOID_RSA_RSA) 。
 

[in] dwFlags

指出如何匯出公鑰資訊的 DWORD 旗標值。 將公鑰物件標識碼對應至對應的 CNG 公鑰演演算法 Unicode 字串時，旗標值會直接傳遞至 CryptFindOIDInfo 函式。 您可以設定下列旗標值。

值 意義
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
 略過 CRYPT_PUBKEY_ALG_OID_GROUP_ID 群組中以 CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG 旗標明確標幟的公鑰。
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
 略過 CRYPT_PUBKEY_ALG_OID_GROUP_ID 群組中以 CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG 旗標明確標幟的公鑰。

[in] pvAuxInfo

此參數保留供日後使用，且必須設定為 NULL。

[out] pInfo

要匯出之公鑰資訊的 CERT_PUBLIC_KEY_INFO 結構的指標。

此參數可以是 NULL ，可設定此資訊的大小以供記憶體配置之用。 如需詳細資訊，請參閱 擷取未知長度的數據。

[in, out] pcbInfo

DWORD 的指標，其中包含 pInfo 參數所指向之緩衝區的大小，以位元組為單位。 當函式傳回時， DWORD 會包含儲存在緩衝區中的位元元組數目。

注意 處理緩衝區中傳回的數據時，應用程式必須使用傳回之數據的實際大小。 實際大小可能會稍微小於輸入中指定的緩衝區大小。 (輸入時，緩衝區大小通常會指定夠大，以確保最大可能的輸出數據會符合 buffer。) On 輸出中，此參數所指向的變數會更新，以反映複製到緩衝區的實際數據大小。
 

傳回值

如果函式成功，傳回值為非零 (TRUE) 。

如果函式失敗，傳回值為零， (FALSE) 。 如需擴充的錯誤資訊，請呼叫 GetLastError。

注意 來自所呼叫函式 CryptGetUserKey 和 CryptExportKey 的錯誤可以傳播至此函式。
 
此函式具有下列錯誤碼。
傳回碼 Description
ERROR_FILE_NOT_FOUND
 找不到可針對指定的 dwCertEncodingType 和 pszPublicKeyObjId 參數安裝或註冊的導出函式。
ERROR_MORE_DATA
 如果 pInfo 參數指定的緩衝區不夠大，無法保存傳回的數據，函式會設定ERROR_MORE_DATA程序代碼，並將所需的緩衝區大小以位元組為單位，儲存在 由ERROR_MORE_DATA 參數指向的變數中。
 

如果函式失敗， GetLastError 可能會傳回 抽象語法表示法 1 (ASN.1) 編碼/譯碼錯誤。 如需這些錯誤的相關信息，請參閱 ASN.1 編碼/譯碼傳回值。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 wincrypt.h
程式庫 Crypt32.lib
Dll Crypt32.dll

另請參閱

CryptImportPublicKeyInfoEx

資料管理 函式