Bagikan melalui

IX509PrivateKey::Metode impor (certenroll.h)

  • Artikel

Metode Impor mengimpor kunci privat yang ada ke dalam kontainer kunci dalam penyedia kriptografi.

Sintaks

HRESULT Import(
  [in] BSTR         strExportType,
  [in] BSTR         strEncodedKey,
  [in] EncodingType Encoding
);

Parameter

[in] strExportType

Jika kunci dibuat dengan menggunakan CNG KSP (Penyedia Penyimpanan Kunci), metode Impor meneruskan argumen ini ke parameter pszProperty dari fungsi NCryptSetProperty . Artinya, nilai yang Anda tentukan akan digunakan sebagai nama properti yang akan diatur pada kunci yang diimpor.

Jika kunci dibuat dengan menggunakan CSP CryptoAPI (Penyedia Layanan Kriptografi), argumen ini menentukan bagaimana kunci privat akan diimpor. Ini bisa menjadi nilai berikut.

Nilai Makna
BCRYPT_PRIVATE_KEY_BLOB
 Mengimpor seluruh kunci privat.

[in] strEncodedKey

Variabel BSTR yang berisi kunci yang akan diimpor.

[in] Encoding

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

Nilai kembali

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_FILE_READ_ONLY)
 Kontainer kunci sudah terbuka. Anda dapat menerima kesalahan ini jika Anda telah memanggil Buka atau Buat.
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 Kunci dibuat oleh CSP CryptoAPI dan Anda menentukan nilai selain BCRYPT_PRIVATE_KEY_BLOB untuk parameter strExportType .

Keterangan

Fungsi Impor secara otomatis mengasumsikan bahwa Anda mencoba mengimpor kunci CNG KSP jika Anda menentukan nilai selain BCRYPT_PRIVATE_KEY_BLOB untuk parameter strExportType dan Anda tidak mengatur salah satu properti berikut:

Persyaratan

Persyaratan Nilai
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