Antarmuka ICertRequest (certcli.h)

Antarmuka ICertRequest menyediakan komunikasi antara klien atau aplikasi perantara dan layanan Sertifikat.

Aplikasi klien dan perantara dapat memanggil metode ICertRequest untuk melakukan tugas-tugas berikut:

  • Kirim permintaan sertifikat.
  • Ambil disposisi, status terakhir, dan pengidentifikasi permintaan.
  • Ambil sertifikat yang dikeluarkan untuk permintaan tersebut.
  • Ambil sertifikat yang tertunda untuk permintaan sebelumnya.
  • Ambil sertifikat otoritas sertifikasi (CA) untuk server Layanan Sertifikat.

ICertRequest didefinisikan dalam Certcli.h. Namun, saat Anda membuat program, gunakan Certsrv.h sebagai file sertakan. Certcli.dll menyediakan antarmuka ICertRequest . Informasi jenis untuk antarmuka ini juga ada di Certclil.dll, yang dikirim dengan Platform Software Development Kit (SDK).

Antarmuka Layanan Sertifikat mendukung model rangkaian apartemen dan utas bebas. Untuk throughput yang lebih baik, disarankan untuk threading gratis.

Warisan

Antarmuka ICertRequest mewarisi dari antarmuka IDispatch . ICertRequest juga memiliki jenis anggota ini:

Metode

Antarmuka ICertRequest memiliki metode ini.

 
ICertRequest::GetCACertificate

Mengembalikan sertifikat otoritas sertifikasi (CA) untuk server Layanan Sertifikat.
ICertRequest::GetCertificate

Mengembalikan sertifikat yang dikeluarkan untuk permintaan sebagai sertifikat X.509, atau dipaketkan secara opsional dalam Standar Kriptografi Kunci Publik (PKCS)
ICertRequest::GetDispositionMessage

Mendapatkan pesan yang dapat dibaca manusia yang memberikan disposisi permintaan sertifikat saat ini.
ICertRequest::GetLastStatus

Mendapatkan kode pengembalian terakhir untuk permintaan ini. Ini mengembalikan informasi kode kesalahan, bukan disposisi permintaan.
ICertRequest::GetRequestId

Mendapatkan nomor permintaan internal saat ini untuk permintaan dan sertifikat berikutnya.
ICertRequest::RetrievePending

Mengambil status disposisi sertifikat dari permintaan sebelumnya yang mungkin sebelumnya telah mengembalikan CR_DISP_INCOMPLETE atau CR_DISP_UNDER_SUBMISSION.
ICertRequest::Submit

Mengirimkan permintaan ke server Layanan 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)