IX509ExtensionTemplateName-Schnittstelle (certenroll.h)

Die IX509ExtensionTemplateName-Schnittstelle definiert Methoden und Eigenschaften, die zum Initialisieren oder Abrufen einer Vorlagennamenerweiterung 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. Die Vorlage wird durch den Namen identifiziert.

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

 

Die Erweiterung ist als Name-Wert-Paar codiert, wobei name gleich der Unicode-Zeichenfolge "CertificateTemplate" und der zugeordnete Wert der Name der Vorlage ist. Die folgende Syntax zeigt ein Beispiel für die Ausgabe Abstrakte Syntax Notation 1 (ASN.1) für die Vorlage mit dem Namen "User". Der Erweiterungswert wird mithilfe von Distinguished Encoding Rules (DER) codiert.

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"

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 IX509ExtensionTemplateName-Schnittstelle erbt von IX509Extension. IX509ExtensionTemplateName verfügt auch über folgende Membertypen:

Methoden

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

IX509ExtensionTemplateName::get_TemplateName Ruft den Namen der Vorlage ab.
IX509ExtensionTemplateName::InitializeDecode Initialisiert die Erweiterung aus einem Distinguished Encoding Rules (DER)-codierten Bytearray, das den Erweiterungswert enthält. (IX509ExtensionTemplateName.InitializeDecode)
IX509ExtensionTemplateName::InitializeEncode Initialisiert die Erweiterung aus einer Zeichenfolge, die den Vorlagennamen enthält.

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