Interfaz IX509ExtensionTemplateName (certenroll.h)

La interfaz IX509ExtensionTemplateName define métodos y propiedades que se pueden usar para inicializar o recuperar una extensión de nombre de plantilla. Esta extensión se puede colocar en la solicitud de certificado para indicar a la entidad de certificación qué plantilla usar al emitir o renovar un certificado. La plantilla se identifica por nombre.

Nota La extensión CertificateTemplateName se usa para identificar las plantillas de la versión 1. Para identificar una plantilla de versión 2, puede usar la extensión CertificateTemplate definida por la interfaz IX509ExtensionTemplate .

 

La extensión se codifica como un par nombre-valor donde name es igual a la cadena Unicode "CertificateTemplate" y el valor asociado es el nombre de la plantilla. La sintaxis siguiente muestra un ejemplo de la salida notación de sintaxis abstracta One (ASN.1) para la plantilla denominada "User". El valor de extensión se codifica mediante reglas de codificación distinguida (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"

Para agregar este objeto de extensión a una solicitud PKCS #10 o una solicitud CMC, primero debe agregarlo a una colección IX509Extensions y usar la colección para inicializar un objeto IX509AttributeExtensions . Para obtener más información, vea los temas PKCS #10 Extensions y CMC Extensions .

Herencia

La interfaz IX509ExtensionTemplateName hereda de IX509Extension. IX509ExtensionTemplateName también tiene estos tipos de miembros:

Métodos

La interfaz IX509ExtensionTemplateName tiene estos métodos.

IX509ExtensionTemplateName::get_TemplateName Recupera el nombre de la plantilla.
IX509ExtensionTemplateName::InitializeDecode Inicializa la extensión a partir de una matriz de bytes codificada reglas de codificación distinguida (DER) que contiene el valor de extensión. (IX509ExtensionTemplateName.InitializeDecode)
IX509ExtensionTemplateName::InitializeEncode Inicializa la extensión a partir de una cadena que contiene el nombre de la plantilla.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certenroll.h

Consulte también

CertEnroll Interfaces

IX509Extension