Metode ICertPropertyEnrollmentPolicyServer::Initialize (certenroll.h)

Artikel
03/14/2023

Metode Initialize menginisialisasi objek ICertPropertyEnrollmentPolicyServer .

Sintaks

HRESULT Initialize(
  [in] EnrollmentPolicyServerPropertyFlags PropertyFlags,
  [in] X509EnrollmentAuthFlags             AuthFlags,
  [in] X509EnrollmentAuthFlags             EnrollmentServerAuthFlags,
  [in] PolicyServerUrlFlags                UrlFlags,
  [in] BSTR                                strRequestId,
  [in] BSTR                                strUrl,
  [in] BSTR                                strId,
  [in] BSTR                                strEnrollmentServerUrl
);

Parameter

[in] PropertyFlags

Nilai enumerasi EnrollmentPolicyServerPropertyFlags yang menentukan server kebijakan pendaftaran sertifikat (CEP) default. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
DefaultNone	Tidak ada URL server kebijakan default yang telah ditentukan.
DefaultPolicyServer	URL server kebijakan yang dikembalikan oleh GetPolicyServerUrl adalah nilai default ketika URL belum ditentukan.

[in] AuthFlags

Nilai enumerasi X509EnrollmentAuthFlags yang menentukan jenis autentikasi yang digunakan oleh klien untuk mengautentikasi dirinya ke server CEP. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
X509AuthAnonymous	Autentikasi anonim.
X509AuthKerberos	Autentikasi Kerberos.
X509AuthUsername	Hapus nama pengguna teks dan autentikasi kata sandi. Catatan Nama pengguna dan kata sandi dienkripsi sebelum transmisi dan disimpan dengan aman di brankas kredensial di server.
X509AuthCertificate	Sertifikat autentikasi klien diinstal pada komputer lokal dan digunakan oleh server untuk memverifikasi identitas klien.

[in] EnrollmentServerAuthFlags

Nilai enumerasi X509EnrollmentAuthFlags yang menentukan jenis autentikasi yang digunakan oleh klien untuk mengautentikasi dirinya sendiri ke CES. Lihat parameter AuthFlags untuk nilai yang mungkin dari jenis enumerasi. Untuk Windows 7, hanya X509AuthCertificate yang dapat ditentukan.

[in] UrlFlags

Nilai enumerasi PolicyServerUrlFlags yang menentukan bendera server kebijakan. Ini bisa menjadi bitwise ATAU dari nilai berikut.

Nilai	Makna
PsfNone	Tidak ada bendera yang ditentukan.
PsfLocationGroupPolicy	URL server kebijakan ditentukan dalam kebijakan grup oleh administrator.
PsfLocationRegistry	URL server kebijakan ditentukan dalam registri.
PsfUseClientId	Menentukan bahwa pendaftaran dan perpanjangan sertifikat menyertakan data spesifik klien dalam atribut ClientId . Contohnya termasuk nama penyedia layanan kriptografi, nomor versi Windows, nama pengguna, nama DNS komputer, dan nama DNS pengendali domain. Bendera ini telah disertakan untuk mengatasi masalah privasi yang dapat muncul selama pendaftaran ke server yang dikelola oleh administrator selain mereka yang mengelola forest tempat pengguna berada. Dengan tidak mengatur bendera ini, Anda dapat mencegah pengiriman informasi pribadi ke administrator non-lokal.
PsfAutoEnrollmentEnabled	Pendaftaran sertifikat otomatis diaktifkan.
PsfAllowUnTrustedCA	Menentukan bahwa sertifikat OS penerbit tidak perlu dipercaya oleh klien untuk menginstal sertifikat yang ditandatangani oleh CA.

[in] strRequestId

Variabel BSTR yang berisi pengidentifikasi string unik untuk permintaan sertifikat yang akan dikirim ke otoritas sertifikasi selama pendaftaran. String dapat berisi informasi apa pun yang mengidentifikasi permintaan secara unik.

[in] strUrl

Variabel BSTR yang berisi URL untuk server kebijakan pendaftaran sertifikat (CEP).

[in] strId

Variabel BSTR yang berisi ID server CEP.

[in] strEnrollmentServerUrl

Variabel BSTR yang berisi URL untuk server pendaftaran sertifikat.

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_OUTOFMEMORY	Tidak tersedia cukup memori untuk nilai string.

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

ICertPropertyEnrollmentPolicyServer

Bagikan melalui