Compartilhar via


Interface IX509ExtensionTemplateName (certenroll.h)

A interface IX509ExtensionTemplateName define métodos e propriedades que podem ser usados para inicializar ou recuperar uma extensão de nome de modelo. 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. O modelo é identificado pelo nome.

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

 

A extensão é codificada como um par nome-valor em que name é igual à cadeia de caracteres Unicode "CertificateTemplate" e o valor associado é o nome do modelo. A sintaxe a seguir mostra um exemplo da saída ASN.1 ( Abstract Syntax Notation One ) para o modelo chamado "User". O valor da extensão é codificado 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"

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 IX509ExtensionTemplateName herda de IX509Extension. IX509ExtensionTemplateName também tem estes tipos de membros:

Métodos

A interface IX509ExtensionTemplateName tem esses métodos.

 
IX509ExtensionTemplateName::get_TemplateName

Recupera o nome do modelo.
IX509ExtensionTemplateName::InitializeDecode

Inicializa a extensão de uma matriz de bytes codificada em DISTINGUISHED ENCODING RULES (DER) que contém o valor da extensão. (IX509ExtensionTemplateName.InitializeDecode)
IX509ExtensionTemplateName::InitializeEncode

Inicializa a extensão de uma cadeia de caracteres que contém o nome do modelo.

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