IX509NameValuePair-Schnittstelle (certenroll.h)

Artikel
08/22/2023

Die IX509NameValuePair-Schnittstelle stellt ein generisches Name-Wert-Paar dar. Obwohl es einige gängige Name-Wert-Paare gibt, die von der Zertifikatanforderung und der Registrierung erstellt werden, können Sie dieses Objekt verwenden, um einen beliebigen Namen und Wert anzugeben. Eine IX509NameValuePairs-Auflistung kann aus einem IX509Enrollment-Objekt und einem IX509CertificateRequestCmc-Objekt abgerufen werden. Die Auflistungen sind nicht miteinander verknüpft.

Name-Wert-Paare und das Registrierungsobjekt:: Bevor ein IX509Enrollment-Objekt eine Zertifikatanforderung an eine Zertifizierungsstelle (CA) übermittelt, wird die Name-Wert-Auflistung als verkettete Attributzeichenfolge im Format Name1:Value1\Name2:Value2\ codiert. Sie können die Auflistung abrufen, indem Sie die NameValuePairs-Eigenschaft aufrufen. Sie können das IX509NameValuePairs-Objekt verwenden, um der Auflistung Name-Wert-Paare hinzuzufügen.

Name-Wert-Paare und das CMC-Anforderungsobjekt:

Ein CMC-Anforderungsobjekt (IX509CertificateRequestCmc) enthält Sequenzen der ASN.1-Strukturen TaggedAttribute, TaggedRequest und TaggedContentInfo . Weitere Informationen finden Sie unter CMC-Attribute.

Die TaggedAttribute-Struktur kann ein RegInfo-Attribut enthalten. Dieses Attribut besteht aus einem Bytearray, das die Name-Wert-Paarauflistung enthält. Das Bytearray wird wie folgt erstellt:

Jede Name-Wert-Zeichenfolge ist standardisiert. Beispielsweise werden Escapezeichen vom Typ "%5C" durch umgekehrte Schrägstriche (\\) ersetzt.
Jedes Name-Wert-Paar wird mit einem Gleichheitszeichen (=) verkettet.
Alle Paare werden mithilfe eines Amper- und (&) zwischen jedem Paar verkettet.
Das Ergebnis wird als UTF-8-Zeichenfolge codiert.

Das folgende Beispiel zeigt die ASN.1-Ausgabe für ein CMC-Zertifikat, das ein RegInfo-Attribut enthält, das ein einzelnes Name-Wert-Paar von "RequesterName=Domain\TargetUser" enthält.


...
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&amp; 
...

Vererbung

Die IX509NameValuePair-Schnittstelle erbt von der IDispatch-Schnittstelle . IX509NameValuePair verfügt auch über folgende Membertypen:

Methoden

Die IX509NameValuePair-Schnittstelle verfügt über diese Methoden.


IX509NameValuePair::get_Name Ruft den Namensteil des Name-Wert-Paars ab.
IX509NameValuePair::get_Value Ruft den Wertteil des Name-Wert-Paares ab.
IX509NameValuePair::Initialize Initialisiert das -Objekt aus Zeichenfolgen, die den Namen und den zugeordneten Wert enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h

Weitere Informationen

CertEnroll-Schnittstellen

IDispatch

IX509NameValuePairs