Freigeben über


IX509ExtensionTemplate-Schnittstelle (certenroll.h)

Die IX509ExtensionTemplate-Schnittstelle definiert Methoden und Eigenschaften, die zum Initialisieren oder Abrufen einer CertificateTemplate-Erweiterung verwendet werden können. Diese Erweiterung kann in die Zertifikatanforderung eingefügt werden, um der Zertifizierungsstelle mitzuteilen, welche Vorlage beim Ausstellen oder Erneuern eines Zertifikats verwendet werden soll.

Hinweis Die CertificateTemplate-Erweiterung wird verwendet, um Vorlagen der Version 2 zu identifizieren. Um eine Vorlage der Version 1 zu identifizieren, können Sie die Erweiterung CertificateTemplateName verwenden, die von der IX509ExtensionTemplateName-Schnittstelle definiert wird.

 
Die folgende Syntax zeigt die Asn.1-Struktur ( Abstract Syntax Notation One ) der Erweiterung. Der Erweiterungswert wird mithilfe von Distinguished Encoding Rules (DER) codiert und in die Zertifikatanforderung eingeschlossen.

----------------------------------------------------------------------
-- 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)

Um dieses Erweiterungsobjekt einer PKCS #10-Anforderung oder einer CMC-Anforderung hinzuzufügen, müssen Sie es zunächst einer IX509Extensions-Auflistung hinzufügen und die Auflistung verwenden, um ein IX509AttributeExtensions-Objekt zu initialisieren. Weitere Informationen finden Sie in den Themen PKCS #10 Erweiterungen und CMC-Erweiterungen .

Vererbung

Die IX509ExtensionTemplate-Schnittstelle erbt von IX509Extension. IX509ExtensionTemplate verfügt auch über folgende Membertypen:

Methoden

Die IX509ExtensionTemplate-Schnittstelle verfügt über diese Methoden.

 
IX509ExtensionTemplate::get_MajorVersion

Ruft die Mindestanzahl der Hauptversion der Zertifikatvorlage ab.
IX509ExtensionTemplate::get_MinorVersion

Ruft die Mindestversionsnummer der Zertifikatvorlage ab.
IX509ExtensionTemplate::get_TemplateOid

Ruft den Vorlagenobjektbezeichner (Template Object Identifier, OID) ab.
IX509ExtensionTemplate::InitializeDecode

Initialisiert die Erweiterung aus einem DER-codierten Bytearray, das den Erweiterungswert enthält.
IX509ExtensionTemplate::InitializeEncode

Initialisiert die Erweiterung aus einem Vorlagenobjektbezeichner (OID) und von Haupt- und Nebenversionsnummern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile certenroll.h

Weitere Informationen

CertEnroll-Schnittstellen

IX509Extension