Interface IX509ExtensionTemplate (certenroll.h)

L’interface IX509ExtensionTemplate définit des méthodes et des propriétés qui peuvent être utilisées pour initialiser ou récupérer une extension CertificateTemplate. 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.

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

 

La syntaxe suivante montre la structure ASN.1 ( Abstract Syntax Notation One ) de l’extension. La valeur de l’extension est encodée à l’aide de Distinguished Encoding Rules (DER) et incluse dans la demande de certificat.

----------------------------------------------------------------------
-- CertificateTemplate
-- XCN_OID_CERTIFICATE_TEMPLATE (1.3.6.1.4.1.311.21.7)
----------------------------------------------------------------------

CertificateTemplate ::= SEQUENCE 
{
   templateID              EncodedObjectID,
   templateMajorVersion    TemplateVersion,
   templateMinorVersion    TemplateVersion OPTIONAL
}

TemplateVersion ::= INTEGER (0..4294967295)

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 IX509ExtensionTemplate hérite de IX509Extension. IX509ExtensionTemplate a également les types de membres suivants :

Méthodes

L’interface IX509ExtensionTemplate a ces méthodes.

IX509ExtensionTemplate ::get_MajorVersion Récupère le numéro de version majeure minimal du modèle de certificat.
IX509ExtensionTemplate ::get_MinorVersion Récupère le numéro de version mineure minimal du modèle de certificat.
IX509ExtensionTemplate ::get_TemplateOid Récupère l’identificateur d’objet de modèle (OID).
IX509ExtensionTemplate ::InitializeDecode Initialise l’extension à partir d’un tableau d’octets encodé en DER qui contient la valeur de l’extension.
IX509ExtensionTemplate ::InitializeEncode Initialise l’extension à partir d’un identificateur d’objet de modèle (OID) et des numéros de version principale et mineure.

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