Antarmuka IX509NameValuePair (certenroll.h)

  • Artikel

Antarmuka IX509NameValuePair mewakili pasangan nama-nilai generik. Meskipun ada beberapa pasangan nama-nilai umum yang dibuat oleh permintaan sertifikat dan proses pendaftaran, Anda dapat menggunakan objek ini untuk menentukan nama dan nilai apa pun. Koleksi IX509NameValuePairs dapat diambil dari objek IX509Enrollment dan objek IX509CertificateRequestCmc . Koleksi tidak terkait.

pasangan nama-nilai dan objek pendaftaran:
Sebelum objek IX509Enrollment mengirimkan permintaan sertifikat ke otoritas sertifikasi (CA), koleksi nilai-nama dikodekan sebagai string atribut gabungan yang memiliki format Name1:Value1\Name2:Value2\. Anda dapat mengambil koleksi dengan memanggil properti NameValuePairs . Anda dapat menggunakan objek IX509NameValuePairs untuk menambahkan pasangan nama-nilai ke koleksi.
pasangan nama-nilai dan objek permintaan CMC:
Objek permintaan CMC (IX509CertificateRequestCmc) berisi urutan struktur TaggedAttribute, TaggedRequest, dan TaggedContentInfo ASN.1. Untuk informasi selengkapnya, lihat Atribut CMC

Struktur TaggedAttribute dapat berisi atribut RegInfo . Atribut ini terdiri dari array byte yang berisi kumpulan pasangan nama-nilai. Array byte dibuat dengan cara berikut:

  • Setiap string nama-nilai distandarkan. Misalnya, escape "%5C" digantikan untuk karakter garis miring terbalik (\\).
  • Setiap pasangan nama-nilai digabungkan dengan menggunakan tanda sama dengan (=).
  • Semua pasangan digabungkan dengan menggunakan ampersand (&)di antara setiap pasangan.
  • Hasilnya dikodekan sebagai string UTF-8.

Contoh berikut menunjukkan output ASN.1 untuk sertifikat CMC yang berisi atribut RegInfo yang berisi pasangan nama-nilai tunggal "RequesterName=Domain\TargetUser".


...
30 33              ; SEQUENCE (33 Bytes)
   02 01                            ; INTEGER (1 Bytes)
   |  02
   06 08                            ; OBJECT_ID (8 Bytes)
   |  2b 06 01 05 05 07 07 12
   |     ; 1.3.6.1.5.5.7.7.18 Reg Info
   31 24                ; SET (24 Bytes)
      04 22 ; OCTET_STRING (22 Bytes)
      52 65 71 75 65 73 74 65  72 4e 61 6d 65 3d 44 6f  ; RequesterName=Do
      6d 61 69 6e 25 35 43 54  61 72 67 65 74 55 73 65  ; main%5CTargetUse
      72 26                                             ; r& 
...

Warisan

Antarmuka IX509NameValuePair mewarisi dari antarmuka IDispatch . IX509NameValuePair juga memiliki jenis anggota ini:

Metode

Antarmuka IX509NameValuePair memiliki metode ini.

 
IX509NameValuePair::get_Name

Mengambil bagian nama dari pasangan nama-nilai.
IX509NameValuePair::get_Value

Mengambil bagian nilai dari pasangan nama-nilai.
IX509NameValuePair::Initialize

Menginisialisasi objek dari string yang berisi nama dan nilai terkait.

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

Lihat juga

Antarmuka CertEnroll

IDispatch

IX509NameValuePairs