Interfaz IX509NameValuePair (certenroll.h)
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& ...
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 |