Interfaz IX509AttributeExtensions (certenroll.h)

Artículo
03/08/2023

La interfaz IX509AttributeExtensions define métodos y propiedades que inicializan y recuperan extensiones de certificado en una solicitud de certificado. Por ejemplo, la estructura CertificateRequestInfo de una solicitud PKCS #10 no contiene un campo para las extensiones de la versión 3. En su lugar, las extensiones se deben agregar a la colección de atributos de la solicitud.


CertificationRequestInfo ::= SEQUENCE 
{
   version       INTEGER { v1(0) } (v1,...),
   subject       Name,
   subjectPKInfo SubjectPublicKeyInfo{{ PKInfoAlgorithms }},
   attributes    [0] Attributes{{ CRIAttributes }}
}

Además, las extensiones se incluyen en una solicitud de CMC agregándolas a la estructura TaggedAttributes que se muestra en el siguiente ejemplo de sintaxis abstracta Notation One (ASN.1). Para obtener más información, vea Atributos y extensiones.


CmcData ::= SEQUENCE 
{
   controlSequence         ControlSequence,
   reqSequence             ReqSequence,
   cmsSequence             CmsSequence,
   otherMsgSequence        OtherMsgSequence
}


ControlSequence  ::=    SEQUENCE OF TaggedAttribute

TaggedAttribute ::= SEQUENCE 
{
   bodyPartID              BodyPartID,
   type                    EncodedObjectID,
   values                  AttributeSetValue
}

BodyPartID ::= INTEGER (0..4294967295)
EncodedObjectID ::= OBJECT IDENTIFIER
AttributeSetValue ::= SET OF ANY

Puede crear una o varias extensiones de la versión 3 e incluirlas en una solicitud de certificado de la siguiente manera:

Inicialice cualquiera de los siguientes objetos IX509Extension :
Agregue los objetos de extensión a una colección IX509Extensions .
Utilice la colección IX509Extensions para inicializar un objeto IX509AttributeExtensions .
Agregue el objeto IX509AttributeExtensions a una colección IX509Attributes .
Utilice la colección IX509Attributes para inicializar un objeto ICryptAttribute .
Inicialice un objeto de solicitud CMC o PKCS #10 y recupere la colección ICryptAttributes .
Agregue el objeto ICryptAttribute a la colección ICryptAttributes para la solicitud.

Herencia

La interfaz IX509AttributeExtensions hereda de IX509Attribute. IX509AttributeExtensions también tiene estos tipos de miembros:

Métodos

La interfaz IX509AttributeExtensions tiene estos métodos.


IX509AttributeExtensions::get_X509Extensions Recupera las extensiones de certificado.
IX509AttributeExtensions::InitializeDecode Inicializa el objeto a partir de una matriz de bytes codificada reglas de codificación distinguida (DER) que contiene el valor del atributo. (IX509AttributeExtensions.InitializeDecode)
IX509AttributeExtensions::InitializeEncode Inicializa el objeto de una colección IX509Extensions.

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

IX509Attribute

IX509Attributes