Interface IX509AttributeExtensions (certenroll.h)

Artigo
03/08/2023

A interface IX509AttributeExtensions define métodos e propriedades que inicializam e recuperam extensões de certificado em uma solicitação de certificado. Por exemplo, a estrutura CertificateRequestInfo de uma solicitação PKCS nº 10 não contém um campo para extensões da versão 3. Em vez disso, as extensões devem ser adicionadas à coleção de atributos na solicitação.


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

Além disso, as extensões são incluídas em uma solicitação CMC adicionando-as à estrutura TaggedAttributes mostrada no exemplo de sintaxe ASN.1 ( Abstract Syntax Notation One ) a seguir. Para obter mais informações, consulte Atributos e extensões.


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

Você pode criar uma ou mais extensões da versão 3 e incluí-las em uma solicitação de certificado da seguinte maneira:

Inicialize qualquer um dos seguintes objetos IX509Extension :
Adicione os objetos de extensão a uma coleção IX509Extensions .
Use a coleção IX509Extensions para inicializar um objeto IX509AttributeExtensions .
Adicione o objeto IX509AttributeExtensions a uma coleção IX509Attributes .
Use a coleção IX509Attributes para inicializar um objeto ICryptAttribute .
Inicialize um objeto de solicitação CMC ou PKCS nº 10 e recupere a coleção ICryptAttributes .
Adicione o objeto ICryptAttribute à coleção ICryptAttributes para a solicitação.

Herança

A interface IX509AttributeExtensions herda de IX509Attribute. IX509AttributeExtensions também tem estes tipos de membros:

Métodos

A interface IX509AttributeExtensions tem esses métodos.


IX509AttributeExtensions::get_X509Extensions Recupera as extensões de certificado.
IX509AttributeExtensions::InitializeDecode Inicializa o objeto de uma matriz de bytes codificada em DER (Distinguished Encoding Rules) que contém o valor do atributo. (IX509AttributeExtensions.InitializeDecode)
IX509AttributeExtensions::InitializeEncode Inicializa o objeto de uma coleção IX509Extensions.

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

IX509Attribute

IX509Attributes