Metode ICertAdmin2::GetArchivedKey (certadm.h)

Artikel
08/22/2023

Metode GetArchivedKey mengambil BLOB pemulihan kunci yang diarsipkan. Metode ini pertama kali didefinisikan dalam antarmuka ICertAdmin .

Sintaks

HRESULT GetArchivedKey(
  [in]  const BSTR strConfig,
  [in]  LONG       RequestId,
  [in]  LONG       Flags,
  [out] BSTR       *pstrArchivedKey
);

Parameter

[in] strConfig

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.

GetArchivedKeypenting 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

Mewakili ID permintaan sertifikat dalam database Certificates Services.

[in] Flags

Bendera berikut dapat digunakan untuk menentukan format BLOB yang dikembalikan.

Nilai	Makna
CR_OUT_BASE64	BASE64 tanpa BEGIN/END
CR_OUT_BASE64HEADER	BASE64 dengan SERTIFIKAT MULAI dan SERTIFIKAT AKHIR
CV_OUT_BINARY	Biner

[out] pstrArchivedKey

Penunjuk ke string yang mewakili BLOB kunci yang diarsipkan yang diambil. Ketika Anda telah selesai menggunakan string ini, pemanggil bertanggung jawab untuk membebaskannya dengan memanggil fungsi SysFreeString .

Mengembalikan nilai

C++

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan metode berhasil.

VB

String yang berisi BLOB kunci yang diarsipkan yang diambil.

Keterangan

Kunci yang diarsipkan dienkripsi dalam PKCS #7 ke sertifikat atau sertifikat agen pemulihan kunci, dan disimpan dalam database Layanan Sertifikat dalam formulir tersebut. Metode ini mengambil PKCS terenkripsi #7 dari database Layanan Sertifikat, membungkusnya dalam PKCS #7 yang ditandatangani yang berisi sertifikat dan rantai pengguna, sertifikat atau sertifikat agen pemulihan kunci, dan sertifikat dan rantai penandatanganan otoritas sertifikasi. Atribut terautentikasi berisi sertifikat yang digunakan untuk mengidentifikasi sertifikat pengguna secara unik.

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

Bagikan melalui