Interfaz IX509ExtensionTemplate (certenroll.h)

  • Artículo

La interfaz IX509ExtensionTemplate define métodos y propiedades que se pueden usar para inicializar o recuperar una extensión CertificateTemplate . 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.

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

 
La sintaxis siguiente muestra la estructura Abstract Syntax Notation One (ASN.1) de la extensión. El valor de extensión se codifica mediante reglas de codificación distinguida (DER) y se incluye en la solicitud de certificado. 

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

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 (Extensiones de PKCS #10 ) y CMC Extensions (Extensiones de CMC ).

Herencia

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

Métodos

La interfaz IX509ExtensionTemplate tiene estos métodos.

 
IX509ExtensionTemplate::get_MajorVersion

Recupera el número de versión principal mínimo de la plantilla de certificado.
IX509ExtensionTemplate::get_MinorVersion

Recupera el número mínimo de versión secundaria de la plantilla de certificado.
IX509ExtensionTemplate::get_TemplateOid

Recupera el identificador de objeto de plantilla (OID).
IX509ExtensionTemplate::InitializeDecode

Inicializa la extensión a partir de una matriz de bytes codificada por DER que contiene el valor de extensión.
IX509ExtensionTemplate::InitializeEncode

Inicializa la extensión a partir de un identificador de objeto de plantilla (OID) y de los números de versión principal y secundaria.

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