Bagikan melalui


Metode IX509Enrollment2::InitializeFromTemplate (certenroll.h)

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