IX509CertificateRequest::Initialize method (certenroll.h)

Artikel
02/28/2024

Metode Inisialisasi menginisialisasi objek permintaan untuk pengguna atau komputer.

Sintaks

HRESULT Initialize(
  [in] X509CertificateEnrollmentContext Context
);

Parameter

[in] Context

Nilai enumerasi X509CertificateEnrollmentContext yang menentukan apakah sertifikat ditujukan untuk pengguna akhir, komputer, atau administrator yang bertindak atas nama komputer. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
ContextUser	Sertifikat sedang diminta untuk pengguna akhir.
ContextMachine	Sertifikat sedang diminta 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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Objek sudah diinisialisasi.

Keterangan

Metode Inisialisasi menginisialisasi berbagai objek tergantung pada jenis permintaan sertifikat yang dibuat. Jika Anda memanggil metode ini dari objek IX509CertificateRequestPkcs10 , objek kunci privat dibuat dan objek berikut diinisialisasi:

Koleksi ICryptAttributes kosong.
Koleksi IX509Extensions kosong.
Koleksi IObjectIds yang berisi pengidentifikasi objek ekstensi penting default, XCN_OID_KEY_USAGE dan XCN_OID_BASIC_CONSTRAINTS2. Koleksi ini dapat diambil dengan memanggil properti CriticalExtensions .
Koleksi IObjectIds kosong untuk properti SuppressOids .
Objek ICspInformations yang berisi nilai yang Anda tentukan dalam properti CSPInformations atau kumpulan semua penyedia yang diinstal di komputer. Koleksi ini digunakan untuk membuat kunci privat.

Jika Anda memanggil metode ini dari objek IX509CertificateRequestCmc , permintaan #10 PKCS dalam dibuat seperti di atas dan objek berikut diinisialisasi:

Koleksi ICryptAttributes kosong.
Koleksi IX509NameValuePairs kosong.
Koleksi IX509Extensions kosong.
Koleksi IObjectIds yang berisi pengidentifikasi objek ekstensi penting default, XCN_OID_KEY_USAGE dan XCN_OID_BASIC_CONSTRAINTS2. Koleksi ini dapat diambil dengan memanggil properti CriticalExtensions .
Koleksi IObjectIds kosong untuk properti SuppressOids .
Koleksi ISignerCertificates kosong.

Jika Anda memanggil metode ini dari objek IX509CertificateRequestPkcs7 , permintaan #10 PKCS dalam dibuat seperti di atas.

Properti berikut dapat dipanggil sebelum Anda memanggil metode ini.

Anda harus memanggil properti CSPInformations sebelum memanggil metode ini jika Anda ingin menentukan koleksi ICspInformations .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenroll.h
DLL	CertEnroll.dll