IX509NameValuePair, interface (certenroll.h)
L’interface IX509NameValuePair représente une paire nom-valeur générique. Bien qu’il existe quelques paires nom-valeur courantes créées par le processus de demande de certificat et d’inscription, vous pouvez utiliser cet objet pour spécifier n’importe quel nom et valeur. Une collection IX509NameValuePairs peut être récupérée à partir d’un objet IX509Enrollment et d’un objet IX509CertificateRequestCmc . Les collections ne sont pas liées.
- paires nom-valeur et l’objet d’inscription :
- Avant qu’un objet IX509Enrollment envoie une demande de certificat à une autorité de certification, la collection nom-valeur est encodée en tant que chaîne d’attribut concaténée au format Name1 :Value1\Name2 :Value2\. Vous pouvez récupérer la collection en appelant la propriété NameValuePairs . Vous pouvez utiliser l’objet IX509NameValuePairs pour ajouter des paires nom-valeur à la collection.
- paires nom-valeur et l’objet de requête CMC :
-
Un objet de requête CMC (IX509CertificateRequestCmc) contient des séquences de structures TaggedAttribute, TaggedRequest et TaggedContentInfo ASN.1. Pour plus d’informations, consultez Attributs CMC.
La structure TaggedAttribute peut contenir un attribut RegInfo . Cet attribut se compose d’un tableau d’octets qui contient la collection de paires nom-valeur. Le tableau d’octets est créé de la manière suivante :
- Chaque chaîne nom-valeur est standardisée. Par exemple, les échappements « %5C » sont remplacés par les caractères barre oblique inverse (\\).
- Chaque paire nom-valeur est concaténée à l’aide d’un signe égal (=).
- Toutes les paires sont concaténées à l’aide d’une esperluette (&) entre chaque paire.
- Le résultat est encodé sous la forme d’une chaîne UTF-8.
L’exemple suivant montre la sortie ASN.1 pour un certificat CMC qui contient un attribut RegInfo qui contient une paire nom-valeur unique « 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& ...
Héritage
L’interface IX509NameValuePair hérite de l’interface IDispatch. IX509NameValuePair a également les types de membres suivants :
Méthodes
L’interface IX509NameValuePair utilise ces méthodes.
IX509NameValuePair ::get_Name Récupère la partie nom de la paire nom-valeur. |
IX509NameValuePair ::get_Value Récupère la partie valeur de la paire nom-valeur. |
IX509NameValuePair ::Initialize Initialise l’objet à partir de chaînes qui contiennent le nom et la valeur associée. |
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | certenroll.h |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour