Bagikan melalui

ICertRequest2::GetIssuedCertificate method (certcli.h)

  • Artikel

Metode GetIssuedCertificate mengambil disposisi sertifikat dengan menentukan ID permintaan atau nomor seri sertifikat.

Metode ini secara efektif sama dengan memanggil ICertRequest3::RetrievePending, dengan kemampuan tambahan untuk menentukan nomor seri untuk sertifikat yang dimaksud.

Sintaks

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const BSTR strSerialNumber,
  [out, retval] LONG       *pDisposition
);

Parameter

[in] strConfig

Mewakili string konfigurasi yang valid untuk server Layanan Sertifikat. String dapat berupa URL HTTPS untuk server pendaftaran atau dalam bentuk ComputerName\CAName, di mana ComputerName adalah nama jaringan server, dan CAName adalah nama umum otoritas sertifikasi, seperti yang dimasukkan selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: URL HTTPS tidak didukung sebagai input.

[in] RequestId

Nilai LONG yang mewakili ID permintaan sertifikat dalam database Certificates Services. Gunakan –1 untuk nilai ini jika nomor seri (diteruskan sebagai strSerialNumber) akan digunakan alih-alih ID permintaan.

[in] strSerialNumber

Nilai BSTR yang mewakili nomor seri sertifikat, seperti yang dikeluarkan oleh CA. Agar strSerialNumber digunakan, Anda harus menentukan nilai –1 untuk RequestId.

[out, retval] pDisposition

Penunjuk ke nilai LONG yang mewakili disposisi sertifikat. Disposisi adalah salah satu nilai berikut.

Nilai Makna
CR_DISP_DENIED
 Permintaan ditolak.
CR_DISP_ERROR
 Permintaan gagal.
CR_DISP_INCOMPLETE
 Permintaan tidak selesai.
CR_DISP_ISSUED
 Sertifikat dikeluarkan.
CR_DISP_ISSUED_OUT_OF_BAND
 Sertifikat dikeluarkan secara terpisah.
CR_DISP_UNDER_SUBMISSION
 Permintaan diambil di bawah pengajuan.

Nilai kembali

C++

Jika metode berhasil, metode akan mengembalikan S_OK.

Jika metode gagal, metode mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

VB

Nilai yang dikembalikan adalah Panjang yang mewakili disposisi sertifikat.

Persyaratan

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