Bagikan melalui


Metode IX509CertificateRequestPkcs7::InitializeFromTemplateName (certenroll.h)

Metode InitializeFromTemplateName menginisialisasi permintaan sertifikat dengan menggunakan templat.

Sintaks

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

Parameter

[in] Context

Nilai enumerasi X509CertificateEnrollmentContext yang menentukan apakah sertifikat yang diminta ditujukan untuk pengguna akhir, komputer, atau administrator yang bertindak atas nama komputer.

[in] strTemplateName

Variabel BSTR yang berisi Nama Umum (CN) templat seperti yang muncul di Direktori Aktif atau pengidentifikasi objek desimal putus-putus.

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
ERROR_ALREADY_INITIALIZED
Objek permintaan sertifikat telah diinisialisasi.

Keterangan

Metode InitializeFromTemplateName membuat objek permintaan PKCS #7 dan mengatur properti berikut ke nilai yang ada sebelum metode ini dipanggil:

Metode ini membuat koleksi berikut:
  • Koleksi ICryptAttributes .
  • Koleksi IX509Extensions .
  • Koleksi IObjectIds yang diisi dengan pengidentifikasi objek XCN_OID_KEY_USAGE dan XCN_OID_BASIC_CONSTRAINTS2 default.
  • Koleksi IObjectIds kosong untuk atribut dan OID ekstensi yang akan ditekan dari permintaan baru.

Metode ini kemudian memeriksa templat dan melakukan tindakan berikut:

Jika properti CSPInformationsadalah NULL, metode membuat koleksi ICspInformations dari penyedia yang diinstal di komputer.

Terakhir, metode menetapkan permintaan PKCS #10 yang diinisialisasi sebagai objek permintaan dalam.

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

Lihat juga

IX509CertificateRequestPkcs7