IX509EnrollmentPolicyServer::Initialize method (certenroll.h)

Metode Inisialisasi menginisialisasi objek IX509EnrollmentPolicyServer .

Sintaks

HRESULT Initialize(
  [in] BSTR                             bstrPolicyServerUrl,
  [in] BSTR                             bstrPolicyServerId,
  [in] X509EnrollmentAuthFlags          authFlags,
  [in] VARIANT_BOOL                     fIsUnTrusted,
  [in] X509CertificateEnrollmentContext context
);

Parameter

[in] bstrPolicyServerUrl

Variabel BSTR yang berisi URL untuk server kebijakan pendaftaran sertifikat.

[in] bstrPolicyServerId

Variabel BSTR yang berisi ID unik untuk server kebijakan pendaftaran sertifikat. Jika nilai ini bukan NULL, nilai tersebut harus cocok dengan string ID yang dikembalikan oleh respons CEP.

[in] authFlags

Nilai enumerasi X509EnrollmentAuthFlags yang menentukan jenis autentikasi klien. 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 CEP.
X509AuthCertificate	Sertifikat autentikasi klien diinstal pada komputer lokal dan digunakan oleh server untuk memverifikasi identitas klien.

[in] fIsUnTrusted

Nilai Boolean yang menentukan apakah akan mengizinkan sertifikat otoritas sertifikasi yang tidak tepercaya.

[in] context

Nilai enumerasi X509CertificateEnrollmentContext yang menentukan sifat entitas akhir tempat pendaftaran sertifikat dimaksudkan. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
ContextUser	Sertifikat ini ditujukan untuk pengguna akhir.
ContextMachine	Sertifikat ditujukan untuk komputer.
ContextAdministratorForceMachine	Sertifikat sedang diminta oleh administrator yang bertindak atas nama komputer.

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 bstrPolicyServerUrl tidak boleh berupa string kosong dan harus mewakili URL HTTPS.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk string yang ditentukan dalam parameter bstrPolicyServerUrl atau bstrPolicyServerId .
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Objek IX509EnrollmentPolicyServer telah diinisialisasi.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)	Nilai yang ditentukan dalam parameter bstrPolicyServerId bukan NULL dan tidak sama dengan nilai ID CEP yang ada di server CEP.

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

IX509EnrollmentPolicyServer