IX509PrivateKey::Metode ekspor (certenroll.h)

Artikel
03/14/2023

Metode Ekspor menyalin kunci privat ke array byte. Array byte diwakili oleh string yang dikodekan Unicode.

Sintaks

HRESULT Export(
  [in]  BSTR         strExportType,
  [in]  EncodingType Encoding,
  [out] BSTR         *pstrEncodedKey
);

Parameter

[in] strExportType

Nilai BSTR yang menentukan bagaimana kunci privat diekspor.

Jika kunci dibuat dengan menggunakan CNG KSP (Penyedia Penyimpanan Kunci), Anda dapat menentukan salah satu nilai yang diizinkan oleh parameter pszBlobType dalam fungsi NCryptExportKey .

Jika kunci dibuat dengan menggunakan CSP CryptoAPI (Penyedia Layanan Kriptografi), Anda dapat menentukan salah satu nilai berikut dari file header Bcrypt.h yang disertakan dengan Wincrypt.h.

Nilai	Makna
BCRYPT_PUBLIC_KEY_BLOB	Hanya mengekspor bagian publik dari kunci privat.
BCRYPT_PRIVATE_KEY_BLOB	Mengekspor seluruh kunci privat.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang akan diterapkan ke string yang terkandung dalam parameter pstrEncodedKey . Nilai defaultnya adalah XCN_CRYPT_STRING_BASE64.

[out] pstrEncodedKey

Penunjuk ke variabel BSTR yang berisi kunci privat.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Menampilkan kode	Deskripsi
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)	Kunci dibuat oleh CSP CryptoAPI dan Anda menentukan nilai selain BCRYPT_PRIVATE_KEY_BLOB atau BCRYPT_PUBLIC_KEY_BLOB untuk parameter strExportType .

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenroll.h
DLL	CertEnroll.dll

Lihat juga

IX509PrivateKey

Bagikan melalui