Metode IX509CertificateRequestCmc::InitializeFromInnerRequestTemplateName (certenroll.h)

Artikel
02/28/2024

Metode InitializeFromInnerRequestTemplateName menginisialisasi permintaan sertifikat dari objek permintaan dalam dan templat.

Sintaks

HRESULT InitializeFromInnerRequestTemplateName(
  [in] IX509CertificateRequest *pInnerRequest,
  [in] BSTR                    strTemplateName
);

Parameter

[in] pInnerRequest

Penunjuk ke antarmuka IX509CertificateRequest yang mewakili objek permintaan dalam. Ini bisa menjadi permintaan PKCS #10 atau CMC.

[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
CRYPT_E_INVALID_MSG_TYPE	Objek permintaan yang diteruskan ke parameter pInnerRequest harus berupa PKCS #10 atau permintaan CMC.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Objek permintaan telah diinisialisasi.

Keterangan

Dengan menentukan templat, Anda dapat menambahkan informasi ke objek permintaan luar yang mungkin tidak terkandung dalam permintaan dalam. Misalnya, jika permintaan dalam tidak berisi ekstensi yang diperlukan, Anda dapat menyediakan templat yang melakukannya.

Metode InitializeFromInnerRequestTemplateName :

Membuat koleksi ICryptAttributes kosong.
Membuat koleksi IX509NameValuePairs kosong.
Membuat koleksi IX509Extensions kosong.
Membuat koleksi IObjectIds untuk ekstensi penting dan menambahkan pengidentifikasi objek XCN_OID_KEY_USAGE dan XCN_OID_BASIC_CONSTRAINTS2 (OID).
Membuat kumpulan OID IObjectIds kosong untuk ditekan dari objek permintaan.
Membuat koleksi ISignerCertificates kosong.
Mengambil bendera kunci privat dari templat.
Mengatur properti ArchivePrivateKey jika diperlukan oleh bendera atau pengaturan templat.
Mengambil algoritma enkripsi dari templat jika ditentukan dan mengatur properti EncryptionAlgorithm .
Mengatur properti EncryptionStrength jika memungkinkan.

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

IX509CertificateRequestCmc