Interface IX509ExtensionTemplateName (certenroll.h)
L’interface IX509ExtensionTemplateName définit des méthodes et des propriétés qui peuvent être utilisées pour initialiser ou récupérer une extension de nom de modèle. Cette extension peut être placée dans la demande de certificat pour indiquer à l’autorité de certification le modèle à utiliser lors de l’émission ou du renouvellement d’un certificat. Le modèle est identifié par son nom.
L’extension est encodée sous la forme d’une paire nom-valeur où name est égal à la chaîne Unicode « CertificateTemplate » et la valeur associée est le nom du modèle. La syntaxe suivante montre un exemple de sortie ASN.1 ( Abstract Syntax Notation One ) pour le modèle nommé « User ». La valeur de l’extension est encodée à l’aide de Distinguished Encoding Rules (DER).
30 42 ; SEQUENCE (42 Bytes)
| 06 0a ; OBJECT_ID (a Bytes)
| | 2b 06 01 04 01 82 37 0d 02 01
| | ; 1.3.6.1.4.1.311.13.2.1 Enrollment Name Value Pair
| 31 34 ; SET (34 Bytes)
| 30 32 ; SEQUENCE (32 Bytes)
| 1e 26 ; UNICODE_STRING (26 Bytes)
| | 00 43 00 65 00 72 00 74 00 69 00 66 00 69 00 63 ; .C.e.r.t.i.f.i.c
| | 00 61 00 74 00 65 00 54 00 65 00 6d 00 70 00 6c ; .a.t.e.T.e.m.p.l
| | 00 61 00 74 00 65 ; .a.t.e
| | ; "CertificateTemplate"
| 1e 08 ; UNICODE_STRING (8 Bytes)
| 00 55 00 73 00 65 00 72 ; .U.s.e.r
| ; "User"
Pour ajouter cet objet d’extension à une requête PKCS #10 ou une requête CMC, vous devez d’abord l’ajouter à une collection IX509Extensions et utiliser la collection pour initialiser un objet IX509AttributeExtensions . Pour plus d’informations, consultez les rubriques Extensions PKCS #10 et Extensions CMC .
Héritage
L’interface IX509ExtensionTemplateName hérite de IX509Extension. IX509ExtensionTemplateName a également les types de membres suivants :
Méthodes
L’interface IX509ExtensionTemplateName contient ces méthodes.
| IX509ExtensionTemplateName ::get_TemplateName Récupère le nom du modèle. |
| IX509ExtensionTemplateName ::InitializeDecode Initialise l’extension à partir d’un tableau d’octets encodé Distinguished Encoding Rules (DER) qui contient la valeur d’extension. (IX509ExtensionTemplateName.InitializeDecode) |
| IX509ExtensionTemplateName ::InitializeEncode Initialise l’extension à partir d’une chaîne qui contient le nom du modèle. |
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 |