Interfaz IX509NameValuePair (certenroll.h)

Artículo
03/14/2023

La interfaz IX509NameValuePair representa un par nombre-valor genérico. Aunque hay algunos pares de nombre-valor comunes creados por el proceso de solicitud de certificado y inscripción, puede usar este objeto para especificar cualquier nombre y valor. Se puede recuperar una colección IX509NameValuePairs de un objeto IX509Enrollment y un objeto IX509CertificateRequestCmc . Las colecciones no están relacionadas.

pares nombre-valor y el objeto de inscripción:: Antes de que un objeto IX509Enrollment envíe una solicitud de certificado a una entidad de certificación (CA), la colección name-value se codifica como una cadena de atributo concatenada que tiene el formato Name1:Value1\Name2:Value2\. Puede recuperar la colección llamando a la propiedad NameValuePairs . Puede usar el objeto IX509NameValuePairs para agregar pares nombre-valor a la colección.

pares nombre-valor y el objeto de solicitud de CMC:

Un objeto de solicitud CMC (IX509CertificateRequestCmc) contiene secuencias de estructuras TaggedAttribute, TaggedRequest y TaggedContentInfo ASN.1. Para obtener más información, consulte Atributos de CMC.

La estructura TaggedAttribute puede contener un atributo RegInfo . Este atributo consta de una matriz de bytes que contiene la colección de pares nombre-valor. La matriz de bytes se crea de la siguiente manera:

Cada cadena de nombre-valor está estandarizada. Por ejemplo, los caracteres de escape "%5C" se sustituyen por caracteres de barra diagonal inversa (\\).
Cada par nombre-valor se concatena mediante un signo igual (=).
Todos los pares se concatenan mediante una y comercial (&)entre cada par.
El resultado se codifica como una cadena UTF-8.

En el ejemplo siguiente se muestra la salida de ASN.1 para un certificado CMC que contiene un atributo RegInfo que contiene un único par nombre-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; 
...

Herencia

La interfaz IX509NameValuePair hereda de la interfaz IDispatch . IX509NameValuePair también tiene estos tipos de miembros:

Métodos

La interfaz IX509NameValuePair tiene estos métodos.


IX509NameValuePair::get_Name Recupera la parte de nombre del par nombre-valor.
IX509NameValuePair::get_Value Recupera la parte de valor del par nombre-valor.
IX509NameValuePair::Initialize Inicializa el objeto a partir de cadenas que contienen el nombre y el valor asociado.

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

IDispatch

IX509NameValuePairs