Metode IX509CertificateRequest::Encode (certenroll.h)
Metode Encode menandatangani dan mengodekan permintaan sertifikat dan membuat pasangan kunci jika tidak ada. Permintaan dikodekan dengan menggunakan Distinguished Encoding Rules (DER) seperti yang didefinisikan oleh standar Abstract Syntax Notation One (ASN.1). Proses pengodean membuat array byte. Anda dapat mengambil array byte dengan memanggil properti RawData .
Sintaks
HRESULT Encode();
Mengembalikan nilai
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 |
|---|---|
|
Properti ArchivePrivateKey telah ditetapkan untuk permintaan CMC tetapi sertifikat pertukaran kunci tidak dapat ditemukan. |
|
Objek tidak diinisialisasi. |
Keterangan
Untuk permintaan PKCS #10, metode ini:
- Updates kunci privat atau membuat kunci jika perlu.
- Mengisi kunci publik dari kunci privat.
- Updates ekstensi, menambahkan ekstensi default apa pun dan memperhitungkan koleksi OID yang ditekan dan koleksi OID ekstensi penting.
- Updates atribut, menambahkan atribut default dan memperhitungkan koleksi OID yang ditekan.
- Merakit dan mengodekan permintaan yang diperbarui yang tidak ditandatangani.
- Membuat dan mengodekan tanda tangan.
- Mengodekan tanda tangan dan permintaan yang tidak ditandatangani.
Untuk permintaan CMC, metode ini:
- Mengodekan semua objek permintaan dalam.
- Updates ekstensi untuk objek permintaan luar, menambahkan ekstensi default apa pun dan memperhitungkan koleksi OID yang ditekan dan koleksi OID ekstensi penting.
- Updates atribut untuk objek permintaan luar, menambahkan atribut default dan memperhitungkan koleksi OID yang ditekan.
- Updates kumpulan pasangan nama-nilai.
- Mengodekan konten CMC yang terdiri dari permintaan dalam yang dikodekan dan permintaan luar yang diperbarui.
- Membuat dan mengodekan tanda tangan untuk setiap sertifikat penandatanganan.
- Membuat dan mengodekan tanda tangan utama.
- Menyusun konten CMC yang dikodekan (termasuk permintaan dalam dan permintaan luar yang diperbarui) dan tanda tangan yang dikodekan.
- Mengodekan konten yang dirakit ke dalam pesan PKCS #7.
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 |