IX509NameValuePair-Schnittstelle (certenroll.h)
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& ...
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 |