Partager via


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

CertEnroll Interfaces

IDispatch

IX509NameValuePairs