Interface IX509NameValuePair (certenroll.h)

Artigo
01/10/2024

A interface IX509NameValuePair representa um par nome-valor genérico. Embora existam alguns pares nome-valor comuns criados pelo processo de solicitação de certificado e registro, você pode usar esse objeto para especificar qualquer nome e valor. Uma coleção IX509NameValuePairs pode ser recuperada de um objeto IX509Enrollment e de um objeto IX509CertificateRequestCmc . As coleções não estão relacionadas.

pares name-value e o objeto de registro:: Antes que um objeto IX509Enrollment envie uma solicitação de certificado para uma AC (autoridade de certificação), a coleção name-value é codificada como uma cadeia de caracteres de atributo concatenada que tem o formato Name1:Value1\Name2:Value2\. Você pode recuperar a coleção chamando a propriedade NameValuePairs . Você pode usar o objeto IX509NameValuePairs para adicionar pares nome-valor à coleção.

pares name-value e o objeto de solicitação CMC:

Um objeto de solicitação CMC (IX509CertificateRequestCmc) contém sequências de estruturas TaggedAttribute, TaggedRequest e TaggedContentInfo ASN.1. Para obter mais informações, consulte Atributos do CMC

A estrutura TaggedAttribute pode conter um atributo RegInfo . Esse atributo consiste em uma matriz de bytes que contém a coleção de pares nome-valor. A matriz de bytes é criada da seguinte maneira:

Cada cadeia de caracteres nome-valor é padronizada. Por exemplo, escapes "%5C" são substituídos por caracteres de barra invertida (\\).
Cada par nome-valor é concatenado usando um sinal de igual (=).
Todos os pares são concatenados usando um e comercial (&)entre cada par.
O resultado é codificado como uma cadeia de caracteres UTF-8.

O exemplo a seguir mostra a saída do ASN.1 para um certificado CMC que contém um atributo RegInfo que contém um único par nome-valor de "RequesterName=Domain\TargetUser".


...
30 33              ; SEQUENCE (33 Bytes)
   02 01                            ; INTEGER (1 Bytes)
   |  02
   06 08                            ; OBJECT_ID (8 Bytes)
   |  2b 06 01 05 05 07 07 12
   |     ; 1.3.6.1.5.5.7.7.18 Reg Info
   31 24                ; SET (24 Bytes)
      04 22 ; OCTET_STRING (22 Bytes)
      52 65 71 75 65 73 74 65  72 4e 61 6d 65 3d 44 6f  ; RequesterName=Do
      6d 61 69 6e 25 35 43 54  61 72 67 65 74 55 73 65  ; main%5CTargetUse
      72 26                                             ; r&amp; 
...

Herança

A interface IX509NameValuePair herda da interface IDispatch . IX509NameValuePair também tem estes tipos de membros:

Métodos

A interface IX509NameValuePair tem esses métodos.


IX509NameValuePair::get_Name Recupera a parte do nome do par nome-valor.
IX509NameValuePair::get_Value Recupera a parte de valor do par nome-valor.
IX509NameValuePair::Initialize Inicializa o objeto de cadeias de caracteres que contêm o nome e o valor associado.

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

IDispatch

IX509NameValuePairs