Share via

Metode ICertAdmin2::ImportKey (certadm.h)

  • Artikel

Metode ImportKey menambahkan kunci terenkripsi yang diatur ke item dalam database Layanan Sertifikat. Set kunci dienkripsi ke satu atau beberapa sertifikat agen pemulihan kunci (KRA).

Sintaks

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

Parameter

[in] strConfig

Nilai string yang mewakili string konfigurasi yang valid untuk otoritas sertifikasi (CA) dalam bentuk COMPUTERNAME\CANAME, di mana COMPUTERNAME adalah nama jaringan server Certificate Services, dan CANAME adalah nama umum CA, seperti yang dimasukkan selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig.

ImportKeypenting tidak menghapus cache internal saat string konfigurasi diubah. Saat Anda mengubah string konfigurasi untuk CA, Anda harus membuat instans objek ICertAdmin baru dan memanggil metode ini lagi dengan string konfigurasi baru.
 

[in] RequestId

Nilai LONG yang mewakili ID permintaan sertifikat dalam database Certificates Services. Jika nomor seri (diteruskan sebagai strCertHash) akan digunakan alih-alih ID permintaan, gunakan nol untuk nilai ini.

[in] strCertHash

Nilai string yang mewakili hash sertifikat. Agar strCertHash digunakan, Anda harus menentukan nilai nol untuk RequestId.

[in] Flags

Menentukan format kunci. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
CR_IN_BASE64HEADER
 Format BASE64 dengan awal atau akhir.
CR_IN_BASE64
 Format BASE64 tanpa awal atau akhir.
CR_IN_BINARY
 Format biner.
 

Selain itu, nilai berikut dapat dikombinasikan dengan nilai format dengan menggunakan operasi bitwise-OR.

Nilai Makna
IKF_OVERWRITE
 Setiap informasi yang dikodekan KRA yang ada ditimpa.

[in] strKey

Nilai string yang mewakili informasi kunci KRA.

Nilai kembali

Tidak ada

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header certadm.h (termasuk Certsrv.h)
Pustaka Certidl.lib
DLL Certadm.dll

Lihat juga

ICertAdmin2