Metode IX509CertificateRequestCmc2::InitializeFromInnerRequestTemplate (certenroll.h)
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 |
---|---|
|
Objek permintaan yang diteruskan ke parameter pInnerRequest harus berupa PKCS #10 atau permintaan CMC. |
|
Parameter pInnerRequest, pPolicyServer, dan pTemplate tidak boleh NULL. |
|
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 |