AlternativeNameType enumeration

The AlternativeNameType enumeration specifies the alternative name types that can be specified when initializing an IAlternativeName object. Alternative names are used to create a version 3 X.509 AlternativeNames extension. You can create this extension by using the IX509ExtensionAlternativeNames interface.

Syntax

typedef enum  { 
  XCN_CERT_ALT_NAME_UNKNOWN              = 0,
  XCN_CERT_ALT_NAME_OTHER_NAME           = 1,
  XCN_CERT_ALT_NAME_RFC822_NAME          = 2,
  XCN_CERT_ALT_NAME_DNS_NAME             = 3,
  XCN_CERT_ALT_NAME_DIRECTORY_NAME       = 5,
  XCN_CERT_ALT_NAME_URL                  = 7,
  XCN_CERT_ALT_NAME_IP_ADDRESS           = 8,
  XCN_CERT_ALT_NAME_REGISTERED_ID        = 9,
  XCN_CERT_ALT_NAME_GUID                 = 10,
  XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME  = 11
} AlternativeNameType;

Constants

XCN_CERT_ALT_NAME_UNKNOWN

The name type is not identified.

XCN_CERT_ALT_NAME_OTHER_NAME

The name consists of an object identifier (OID) and a byte array that contains the name value.

XCN_CERT_ALT_NAME_RFC822_NAME

The name is an email address such as someone@example.com.

XCN_CERT_ALT_NAME_DNS_NAME

The name is a Domain Name System (DNS) name such as MyDomain.Microsoft.com. The format of a DNS name is Host.Entity.Domain. For more information about DNS, see RFC 1034 (Domain Names—Concepts and Facilities), and RFC 1035 (Domain Names—Implementation and Specification).

XCN_CERT_ALT_NAME_DIRECTORY_NAME

The name is an X.500 directory name such as CN=administrators,CN=users,DC=nttest,DC=microsoft,DC=com.

XCN_CERT_ALT_NAME_URL

The name is a URL such as http://www.adatum.com/.

XCN_CERT_ALT_NAME_IP_ADDRESS

The name is an Internet Protocol (IP) address in dotted decimal format 123.456.789.123.

XCN_CERT_ALT_NAME_REGISTERED_ID

The name is an object identifier (OID) registered with the International Standards Organization (ISO).

XCN_CERT_ALT_NAME_GUID

The name is a Directory Service Agent GUID. The GUID identifies a server to the Active Directory replication system as a domain controller.

XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME

The name is a user principal name (UPN). A UPN is a user logon name in email address format. That is, a UPN consists of a shorthand name for a user account followed by the DNS name of the Active Directory tree in which the user object resides. It has the form UserName@DNS_suffix. An example is UserName@Microsoft.com where Microsoft.com is the DNS suffix and UserName is a placeholder for a shorthand name assigned by Microsoft to a user account.

Requirements

See also

CertEnroll Enumerations

CertEnroll Interfaces

IAlternativeName

IX509ExtensionAlternativeNames

Send comments about this topic to Microsoft

Build date: 10/26/2012