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.

NoteL’extension CertificateTemplateName est utilisée pour identifier les modèles de version 1. Pour identifier un modèle de version 2, vous pouvez utiliser l’extension CertificateTemplate définie par l’interface IX509ExtensionTemplate .

 

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

Voir aussi

CertEnroll Interfaces

IX509Extension