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) |