IX509Attribute interface

The IX509Attribute interface can be used to represent an attribute in a PKCS #7, PKCS #10, or CMC certificate request. For more information, see the following topics:

Attributes are added to a certificate request to provide a certification authority with additional information that it can use when creating and issuing a certificate. Each attribute is a Distinguished Encoding Rules (DER) encoded Abstract Syntax Notation One (ASN.1) structure that contains an object identifier (OID) and zero or more values as shown by the following syntax.


Attributes ::= SET OF Attribute

Attribute ::= SEQUENCE 
{
   type       EncodedObjectID,
   values     AttributeSetValue
}

The IX509Attribute interface can be used to initialize and retrieve an attribute value. It also serves as the base for the following common attribute interfaces.

Interface/OIDDescription
IX509AttributeClientId

(XCN_OID_REQUEST_CLIENT_INFO)

Represents an attribute that can be used to identify the client that generated a certificate request.
IX509AttributeExtensions

(XCN_OID_RSA_certExtensions)

Represents an attribute that contains certificate extensions in a certificate request.
IX509AttributeArchiveKey

(XCN_OID_ARCHIVED_KEY_ATTR)

Represents an attribute that contains an encrypted private key to be archived by a certification authority.
IX509AttributeArchiveKeyHash

(XCN_OID_ENCRYPTED_KEY_HASH)

Represents an attribute that contains a SHA-1 hash of the encrypted private key to be archived by a certification authority.
IX509AttributeCspProvider

(XCN_OID_ENROLLMENT_CSP_PROVIDER)

Represents an attribute that identifies the cryptographic service provider (CSP) used by the entity requesting the certificate.
IX509AttributeOSVersion

(XCN_OID_OS_VERSION)

Represents an attribute that contains version information about the client operating system on which the certificate request was generated.
IX509AttributeRenewalCertificate

(XCN_OID_RENEWAL_CERTIFICATE)

Represents an attribute that contains the certificate being renewed.

 

Members

The IX509Attribute interface inherits from the IDispatch interface. IX509Attribute also has these types of members:

Methods

The IX509Attribute interface has these methods.

MethodDescription
Initialize

Initializes the object from an OID and a value.

 

Properties

The IX509Attribute interface has these properties.

PropertyDescription

ObjectId

Retrieves an OID for the attribute.

RawData

Retrieves the attribute value.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

CertEnroll.h

DLL

CertEnroll.dll

See also

CertEnroll Interfaces
ICryptAttribute
IX509Attribute
IX509Attributes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.