PFXExportCertStore 関数 (wincrypt.h)

  • [アーティクル]

PFXExportCertStore 関数は、証明書をエクスポートし、使用可能な場合は、参照先の証明書ストアから関連付けられている秘密キーをエクスポートします。 これは、インターネット エクスプローラー 4.0 クライアントとの互換性のために保持される古い関数です。 新しいアプリケーションでは、秘密キーのセキュリティを強化する PfxExportCertStoreEx 関数を使用する必要があります。

構文

BOOL PFXExportCertStore(
  [in]      HCERTSTORE      hStore,
  [in, out] CRYPT_DATA_BLOB *pPFX,
  [in]      LPCWSTR         szPassword,
  [in]      DWORD           dwFlags
);

パラメーター

[in] hStore

エクスポートする証明書を含む証明書ストアのハンドル。

[in, out] pPFX

エクスポートされた証明書とキーを含む PFX パケットを格納する CRYPT_DATA_BLOB 構造体へのポインター。 pPFX-pbData> が NULL の場合、関数はエンコードされた BLOB に必要なバイト数を計算し、pPFX-cbData> でこれを返します。 関数が必要なサイズの割り当てられたバッファーを指す pPFX-pbData> を使用して呼び出されると、関数はエンコードされたバイトをバッファーにコピーし、エンコードバイト長でpPFX-cbData>を更新します。

[in] szPassword

PFX パケットの暗号化と検証に使用される文字列パスワード。 パスワードの使用が完了したら、 SecureZeroMemory 関数を呼び出して、メモリからパスワードをクリアします。 パスワードの保護の詳細については、「パスワードの 処理」を参照してください。

[in] dwFlags

フラグ値は、次の任意の組み合わせに設定できます。

値 意味
EXPORT_PRIVATE_KEYS
 秘密キーは、証明書と同様にエクスポートされます。
REPORT_NO_PRIVATE_KEY
 秘密キーが関連付けられていない証明書が検出された場合、関数は FALSE を 返し、最後のエラーは CRYPT_E_NOT_FOUND または NTE_NO_KEY に設定されます。
REPORT_NOT_ABLE_TO_EXPORT_PRIVATE_KEY
 エクスポートできない秘密キーを持つ証明書が見つかった場合、関数は FALSE を 返し、最後のエラーは NTE_BAD_KEY、NTE_BAD_KEY_STATE、または NTE_PERM に設定されます。

戻り値

関数が成功した場合は TRUE (0 以外) を返し、関数が失敗した場合は FALSE (ゼロ) を返します。 拡張エラー情報については、 GetLastError を呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー wincrypt.h
Library Crypt32.lib
[DLL] Crypt32.dll

こちらもご覧ください

PFXExportCertStoreEx

PFXImportCertStore