共用方式為

CryptExportPKCS8 函式 (wincrypt.h)

  • 發行項

[ CryptExportPKCS8 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。 請改用 PFXExportCertStoreEx 函式。]

CryptExportPKCS8函式會以 PKCS #8 格式匯出私密金鑰。 CryptExportPKCS8Ex已取代函式，在後續版本中可能也會改變或無法使用。

語法

BOOL CryptExportPKCS8(
  [in]            HCRYPTPROV hCryptProv,
  [in]            DWORD      dwKeySpec,
  [in]            LPSTR      pszPrivateKeyObjId,
  [in]            DWORD      dwFlags,
  [in, optional]  void       *pvAuxInfo,
  [out, optional] BYTE       *pbPrivateKeyBlob,
  [in, out]       DWORD      *pcbPrivateKeyBlob
);

參數

[in] hCryptProv

包含密碼編譯服務提供者的HCRYPTPROV變數， (CSP) 。 這是呼叫 CryptAcquireCoNtext取得之 CSP 的控制碼。

[in] dwKeySpec

包含金鑰規格的 DWORD 變數。 預設提供者定義了下列 dwKeySpec 值。

值 意義
AT_KEYEXCHANGE
 用來加密/解密工作階段金鑰的金鑰。
AT_SIGNATURE
 用來建立和驗證數位簽章的金鑰。

[in] pszPrivateKeyObjId

包含私密金鑰物件識別碼的LPSTR變數， (OID) 。

[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，此參數會傳回第二次呼叫函式所需的記憶體配置大小。 如需詳細資訊，請參閱 擷取未知長度的資料。

傳回值

如果函式成功，函式會傳回非零。

如果函式失敗，它會傳回零。 如需擴充錯誤資訊，請呼叫 GetLastError。

下列錯誤碼專屬於此函式。

傳回碼 描述
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
程式庫 Crypt32.lib
Dll Crypt32.dll

另請參閱

CryptAcquireCoNtext

CryptExportPKCS8Ex

擷取未知長度的資料