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
ERROR_UNSUPPORTED_TYPE
 找不到可安裝或註冊的導出函式。
ERROR_MORE_DATA
 如果 pbPrivateKeyBlob 參數指定的緩衝區不夠大，無法保存傳回的數據，則函式會設定ERROR_MORE_DATA程序代碼，並以位元組為單位，儲存以位元組為單位所需的緩衝區大小，以位元組為單位，儲存 於由ERROR_MORE_DATA privateKeyBlob 參數所指向的變數中。
 

如果函式失敗， GetLastError 會傳回 ASN.1 編碼/譯碼錯誤。 如需這些錯誤的相關信息，請參閱 ASN.1 編碼/譯碼傳回值。

備註

只有非對稱金鑰才支援此函式。

規格需求

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

另請參閱

CRYPT_PKCS8_EXPORT_PARAMS

CryptAcquireContext

CryptExportPKCS8

CryptImportPKCS8