Fungsi PFXExportCertStore (wincrypt.h)

  • Artikel

Fungsi PFXExportCertStore mengekspor sertifikat dan, jika tersedia, kunci privat terkait dari penyimpanan sertifikat yang dirujuk. Ini adalah fungsi lama yang disimpan untuk kompatibilitas dengan klien Internet Explorer 4.0. Aplikasi baru harus menggunakan fungsi PfxExportCertStoreEx yang menyediakan keamanan kunci privat yang ditingkatkan.

Sintaks

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

Parameter

[in] hStore

Menangani penyimpanan sertifikat yang berisi sertifikat yang akan diekspor.

[in, out] pPFX

Penunjuk ke struktur CRYPT_DATA_BLOB untuk berisi paket PFX dengan sertifikat dan kunci yang diekspor. Jika pPFX-pbData> adalah NULL, fungsi menghitung jumlah byte yang diperlukan untuk BLOB yang dikodekan dan mengembalikannya dalam pPFX-cbData>. Ketika fungsi dipanggil dengan pPFX-pbData> yang menunjuk ke buffer yang dialokasikan dari ukuran yang diperlukan, fungsi menyalin byte yang dikodekan ke dalam buffer dan memperbaruipPFX-cbData> dengan panjang byte enkode.

[in] szPassword

Kata sandi string yang digunakan untuk mengenkripsi dan memverifikasi paket PFX. Setelah Anda selesai menggunakan kata sandi, hapus kata sandi dari memori dengan memanggil fungsi SecureZeroMemory . Untuk informasi selengkapnya tentang melindungi kata sandi, lihat Menangani Kata Sandi.

[in] dwFlags

Nilai bendera dapat diatur ke kombinasi apa pun dari berikut ini.

Nilai Makna
EXPORT_PRIVATE_KEYS
 Kunci privat diekspor serta sertifikat.
REPORT_NO_PRIVATE_KEY
 Jika sertifikat ditemukan yang tidak memiliki kunci privat terkait, fungsi mengembalikan FALSE dengan kesalahan terakhir yang diatur ke CRYPT_E_NOT_FOUND atau NTE_NO_KEY.
REPORT_NOT_ABLE_TO_EXPORT_PRIVATE_KEY
 Jika sertifikat ditemukan yang memiliki kunci privat yang tidak dapat diekspor, fungsi mengembalikan FALSE dan kesalahan terakhir diatur ke NTE_BAD_KEY, NTE_BAD_KEY_STATE, atau NTE_PERM.

Nilai kembali

Mengembalikan TRUE (bukan nol) jika fungsi berhasil, dan FALSE (nol) jika fungsi gagal. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header wincrypt.h
Pustaka Crypt32.lib
DLL Crypt32.dll

Lihat juga

PFXExportCertStoreEx

PFXImportCertStore