IAlternativeName interface (certenroll.h)
A collection of IAlternativeName interfaces is used by an IX509ExtensionAlternativeNames object to represent an instance of an AlternativeNames extension. The collection is represented by the IAlternativeNames interface. The following syntax shows the Abstract Syntax Notation One (ASN.1) structure of the extension.
----------------------------------------------------------------------
-- AlternativeNames
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------
AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames
GeneralName ::= CHOICE
{
otherName [0] IMPLICIT OtherName,
rfc822Name [1] IMPLICIT IA5STRING,
dNSName [2] IMPLICIT IA5STRING,
x400Address [3] IMPLICIT SeqOfAny, --Not supported
directoryName [4] EXPLICIT ANY,
ediPartyName [5] IMPLICIT SeqOfAny,
uniformResourceLocator [6] IMPLICIT IA5STRING,
iPAddress [7] IMPLICIT OCTETSTRING,
registeredID [8] IMPLICIT EncodedObjectID --Not supported
}
OtherName ::= SEQUENCE
{
type EncodedObjectID,
value [0] EXPLICIT NOCOPYANY
}
You can initialize an IAlternativeName object from an AlternativeNameType enumeration. The following types are available, but they are supported by different initialization methods as indicated.
| Value | Description | Initialization method |
|---|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | The name consists of an object identifier (OID) and a byte array. | InitializeFromOtherName |
| XCN_CERT_ALT_NAME_RFC822_NAME | The name is an email address. | InitializeFromString |
| XCN_CERT_ALT_NAME_DNS_NAME | The name is a Domain Name System (DNS) name. | InitializeFromString |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | The name is an X.500 directory name. | InitializeFromRawData |
| XCN_CERT_ALT_NAME_URL | The name is a URL. | InitializeFromString |
| XCN_CERT_ALT_NAME_IP_ADDRESS | The name is an Internet Protocol (IP) address. | InitializeFromRawData |
| XCN_CERT_ALT_NAME_REGISTERED_ID | The name is a registered OID. | InitializeFromString |
| XCN_CERT_ALT_NAME_GUID | The name is a GUID. | InitializeFromRawData |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | The name is a user principal name (UPN). | InitializeFromString |
Inheritance
The IAlternativeName interface inherits from the IDispatch interface. IAlternativeName also has these types of members:
Methods
The IAlternativeName interface has these methods.
| IAlternativeName::get_ObjectId Retrieves the object identifier (OID), if any, associated with the name. |
| IAlternativeName::get_RawData Retrieves the Distinguished Encoding Rules (DER) encoded byte array that contains the name. |
| IAlternativeName::get_StrValue Retrieves a string that contains an email address, a Domain Name System (DNS) name, a URL, a registered object identifier (OID), or a user principal name (UPN). |
| IAlternativeName::get_Type Retrieves the alternative name type. |
| IAlternativeName::InitializeFromOtherName Initializes the object from an object identifier (OID) and the associated raw data (byte array). |
| IAlternativeName::InitializeFromRawData Initializes the object from a Digital Signature Algorithm (DSA) GUID, an X.500 directory name, or an Internet Protocol (IP) address contained in a Distinguished Encoding Rules (DER) encoded byte array. |
| IAlternativeName::InitializeFromString Initializes the object from a string that contains an email address, a Domain Name System (DNS) name, a URL, a registered object identifier (OID), or a user principal name (UPN). |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | certenroll.h |