Interface IX509ExtensionTemplate (certenroll.h)

Artigo
08/22/2023

A interface IX509ExtensionTemplate define métodos e propriedades que podem ser usados para inicializar ou recuperar uma extensão CertificateTemplate . Essa extensão pode ser colocada na solicitação de certificado para informar à autoridade de certificação qual modelo usar ao emitir ou renovar um certificado.

Nota A extensão CertificateTemplate é usada para identificar modelos da versão 2. Para identificar um modelo de versão 1, você pode usar a extensão CertificateTemplateName definida pela interface IX509ExtensionTemplateName .

A sintaxe a seguir mostra a estrutura ASN.1 ( Abstract Syntax Notation One ) da extensão. O valor da extensão é codificado usando Distinguished Encoding Rules (DER) e incluído na solicitação 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 adicionar esse objeto de extensão a uma solicitação PKCS nº 10 ou uma solicitação CMC, primeiro você deve adicioná-lo a uma coleção IX509Extensions e usar a coleção para inicializar um objeto IX509AttributeExtensions . Para obter mais informações, consulte os tópicos Extensões do PKCS #10 e Extensões do CMC .

Herança

A interface IX509ExtensionTemplate herda de IX509Extension. IX509ExtensionTemplate também tem estes tipos de membros:

Métodos

A interface IX509ExtensionTemplate tem esses métodos.


IX509ExtensionTemplate::get_MajorVersion Recupera o número mínimo de versão principal do modelo de certificado.
IX509ExtensionTemplate::get_MinorVersion Recupera o número mínimo de versão secundária do modelo de certificado.
IX509ExtensionTemplate::get_TemplateOid Recupera o OID (identificador de objeto de modelo).
IX509ExtensionTemplate::InitializeDecode Inicializa a extensão de uma matriz de bytes codificada em DER que contém o valor da extensão.
IX509ExtensionTemplate::InitializeEncode Inicializa a extensão de um OID (identificador de objeto de modelo) e de números de versão principal e secundária.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenroll.h

Confira também

CertEnroll Interfaces

IX509Extension