CryptExportPKCS8Ex 函式 (wincrypt.h)
[ CryptExportPKCS8Ex 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。 請改用 PFXExportCertStoreEx 函式。]
CryptExportPKCS8Ex 函式會以 PKCS #8 格式匯出私鑰。此函式沒有相關聯的匯入連結庫。 您必須使用 LoadLibrary 和 GetProcAddress 函式，以動態方式連結至 Crypt32.dll。
語法
BOOL CryptExportPKCS8Ex(
[in] CRYPT_PKCS8_EXPORT_PARAMS *psExportParams,
[in] DWORD dwFlags,
[in, optional] void *pvAuxInfo,
[out, optional] BYTE *pbPrivateKeyBlob,
[in, out] DWORD *pcbPrivateKeyBlob
);
參數
[in] psExportParams
包含要匯出之索引鍵相關信息 之CRYPT_PKCS8_EXPORT_PARAMS 結構的指標。
[in] dwFlags
如果 pbPrivateKeyBlob 為 NULL ，則此參數應為零，否則為 0x8000。
[in, optional] pvAuxInfo
此參數必須是 NULL。
[out, optional] pbPrivateKeyBlob
要匯出之私鑰的 BYTE 結構數位指標。
私鑰將包含 PKCS #8 PrivateKeyInfo 抽象語法表示 法一 (ASN.1) 類型中找到的資訊 #8 標準。
針對記憶體配置目的，您可以將此參數設定為 NULL，以取得要匯出的私鑰大小。 如需詳細資訊，請參閱 擷取未知長度的數據。
[in, out] pcbPrivateKeyBlob
DWORD 的指標，在輸入上可能包含 pbPrivateKeyBlob 所需的記憶體配置大小，以位元組為單位。 如果 pbPrivateKeyBlob 為 NULL，此參數會傳回第二次呼叫函式所需的記憶體配置大小。 如需詳細資訊，請參閱 擷取未知長度的數據。
傳回值
如果函式成功，函式會傳回非零 (TRUE) 。
如果函式失敗，它會傳回零 (FALSE) 。 如需擴充錯誤資訊，請呼叫 GetLastError。
下列錯誤碼專屬於此函式。
| 傳回碼 | Description |
|---|---|
|
找不到可安裝或註冊的導出函式。 |
|
如果 pbPrivateKeyBlob 參數指定的緩衝區不夠大，無法保存傳回的數據，則函式會設定ERROR_MORE_DATA程序代碼，並以位元組為單位，儲存以位元組為單位所需的緩衝區大小，以位元組為單位，儲存 於由ERROR_MORE_DATA privateKeyBlob 參數所指向的變數中。 |
如果函式失敗， GetLastError 會傳回 ASN.1 編碼/譯碼錯誤。 如需這些錯誤的相關信息，請參閱 ASN.1 編碼/譯碼傳回值。
備註
只有非對稱金鑰才支援此函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | wincrypt.h |
| Dll | Crypt32.dll |