Metode IX509CertificateRequestCmc2::InitializeFromInnerRequestTemplate (certenroll.h)

Artikel
02/28/2024

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

Sintaks

HRESULT InitializeFromInnerRequestTemplate(
  [in] IX509CertificateRequest     *pInnerRequest,
  [in] IX509EnrollmentPolicyServer *pPolicyServer,
  [in] IX509CertificateTemplate    *pTemplate
);

Parameter

[in] pInnerRequest

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

[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
CRYPT_E_INVALID_MSG_TYPE	Objek permintaan yang diteruskan ke parameter pInnerRequest harus berupa PKCS #10 atau permintaan CMC.
E_POINTER	Parameter pInnerRequest, pPolicyServer, dan pTemplate tidak boleh NULL.
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 InitializeFromInnerRequestTemplate :

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 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenroll.h

Lihat juga

IX509CertificateRequestCmc2

Bagikan melalui