Metode IX509Enrollment2::InitializeFromTemplate (certenroll.h)

Artikel
02/28/2024

Metode InitializeFromTemplate menginisialisasi objek pendaftaran dengan menggunakan templat.

Sintaks

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

Parameter

[in] context

Nilai enumerasi X509CertificateEnrollmentContext yang menunjukkan apakah pendaftaran yang diminta adalah untuk pengguna, 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.

[in] pPolicyServer

Penunjuk ke objek IX509EnrollmentPolicyServer yang mewakili server kebijakan pendaftaran sertifikat (CEP) yang berisi templat yang ditentukan oleh parameter pTemplate .

[in] pTemplate

Penunjuk ke objek IX509CertificateTemplate yang mewakili templat yang akan digunakan selama inisialisasi.

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.

Mengembalikan kode/nilai	Deskripsi
E_POINTER	Parameter pPolicyServer dan pTemplate tidak boleh NULL.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Objek pendaftaran telah diinisialisasi.

Keterangan

Metode InitializeFromTemplate :

Memeriksa templat untuk menentukan jenis permintaan yang diperlukan.
Membuat jenis objek permintaan yang sesuai (PKCS #10, PKCS #7, atau CMC).
Mengatur properti berikut pada permintaan jika nilai saat ini ada:
Menginisialisasi objek permintaan dengan menggunakan templat.
Mengambil jumlah tanda tangan, kebijakan penerbitan, dan kebijakan aplikasi dari templat.

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

IX509Enrollment2

Bagikan melalui