Metode IX509CertificateRequest::Encode (certenroll.h)

  • Artikel

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
CERTSRV_E_ARCHIVED_KEY_REQUIRED
 Properti ArchivePrivateKey telah ditetapkan untuk permintaan CMC tetapi sertifikat pertukaran kunci tidak dapat ditemukan.
OLE_E_BLANK
 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

Lihat juga

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation