IX509EnrollmentHelper::Metode pendaftaran (certenroll.h)

Artikel
02/26/2024

Metode Pendaftaran mendaftarkan permintaan sertifikat dan mengambil sertifikat yang dikeluarkan. Metode ini diaktifkan web.

Sintaks

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

Parameter

[in] strEnrollmentPolicyServerURI

BSTR yang berisi URL server kebijakan pendaftaran sertifikat.

[in] strTemplateName

Variabel BSTR yang berisi Nama Umum (CN) templat seperti yang muncul di Direktori Aktif atau pengidentifikasi objek desimal putus-putus.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean yang diterapkan ke array byte untuk tujuan tampilan.

[in] enrollFlags

Nilai enumerasi WebEnrollmentFlags yang menentukan perilaku pendaftaran web. Ini bisa menjadi nilai berikut.

Nilai	Makna
EnrollPrompt	Jika bendera ini diatur dan tidak ada kredensial autentikasi yang tersedia untuk server pendaftaran sertifikat, layanan sertifikat meminta kredensial. Jika tidak ada kredensial autentikasi dan bendera ini tidak diatur, metode Pendaftaran gagal.

[out, retval] pstrCertificate

BSTR yang berisi sertifikat yang diterbitkan.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter strEnrollmentPolicyServerURI dan strTemplateName tidak boleh NULL.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)	Parameter strEnrollmentPolicyServerURI dan strTemplateName melebihi 64.000 karakter atau berisi karakter null yang disematkan.

Keterangan

Metode Pendaftaran mengambil templat yang sesuai, memanggil InitializeFromTemplate, lalu memanggil Pendaftaran pada objek IX509Enrollment .

Metode ini tidak menginstal sertifikat yang dikeluarkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenroll.h

Lihat juga

IX509EnrollmentHelper

Bagikan melalui