Interfaccia IX509ExtensionTemplateName (certenroll.h)

Articolo
08/22/2023

L'interfaccia IX509ExtensionTemplateName definisce metodi e proprietà che possono essere usati per inizializzare o recuperare un'estensione del nome del modello. Questa estensione può essere inserita nella richiesta di certificato per indicare all'autorità di certificazione quale modello usare durante il rilascio o il rinnovo di un certificato. Il modello viene identificato in base al nome.

Nota L'estensione CertificateTemplateName viene usata per identificare i modelli della versione 1. Per identificare un modello versione 2, è possibile usare l'estensione CertificateTemplate definita dall'interfaccia IX509ExtensionTemplate .

L'estensione viene codificata come coppia nome-valore in cui name è uguale alla stringa Unicode "CertificateTemplate" e il valore associato è il nome del modello. La sintassi seguente mostra un esempio dell'output AsN.1 ( Abstract Syntax Notation One ) per il modello denominato "User". Il valore dell'estensione viene codificato usando 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"

Per aggiungere questo oggetto di estensione a una richiesta PKCS #10 o a una richiesta CMC, è innanzitutto necessario aggiungerlo a un insieme IX509Extensions e usare l'insieme per inizializzare un oggetto IX509AttributeExtensions . Per altre informazioni, vedere gli argomenti PKCS #10 Extensions (Estensioni PKCS #10 ) e CMC Extensions (Estensioni CMC ).

Ereditarietà

L'interfaccia IX509ExtensionTemplateName eredita da IX509Extension. IX509ExtensionTemplateName include anche questi tipi di membri:

Metodi

L'interfaccia IX509ExtensionTemplateName include questi metodi.


IX509ExtensionTemplateName::get_TemplateName Recupera il nome del modello.
IX509ExtensionTemplateName::InitializeDecode Inizializza l'estensione da una matrice di byte codificata Distinguished Encoding Rules (DER) che contiene il valore dell'estensione. (IX509ExtensionTemplateName.InitializeDecode)
IX509ExtensionTemplateName::InitializeEncode Inizializza l'estensione da una stringa contenente il nome del modello.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h

Vedi anche

Interfacce CertEnroll

IX509Extension