Edit

Share via

AlternativeNameType enumeration (certenroll.h)

  • Article

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 AlternativeNameType {
  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_X400_ADDRESS = 4,
  XCN_CERT_ALT_NAME_DIRECTORY_NAME = 5,
  XCN_CERT_ALT_NAME_EDI_PARTY_NAME = 6,
  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
} ;

Constants

 
XCN_CERT_ALT_NAME_UNKNOWN
Value: 0
The name type is not identified.
XCN_CERT_ALT_NAME_OTHER_NAME
Value: 1
The name consists of an object identifier (OID) and a byte array that contains the name value.
XCN_CERT_ALT_NAME_RFC822_NAME
Value: 2
The name is an email address such as someone@example.com.
XCN_CERT_ALT_NAME_DNS_NAME
Value: 3
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_X400_ADDRESS
Value: 4
XCN_CERT_ALT_NAME_DIRECTORY_NAME
Value: 5
The name is an X.500 directory name such as CN=administrators,CN=users,DC=nttest,DC=microsoft,DC=com.
XCN_CERT_ALT_NAME_EDI_PARTY_NAME
Value: 6
XCN_CERT_ALT_NAME_URL
Value: 7
The name is a URL such as http://www.adatum.com/.
XCN_CERT_ALT_NAME_IP_ADDRESS
Value: 8
The name is an Internet Protocol (IP) address in dotted decimal format 123.456.789.123.
XCN_CERT_ALT_NAME_REGISTERED_ID
Value: 9
The name is an object identifier (OID) registered with the International Standards Organization (ISO).
XCN_CERT_ALT_NAME_GUID
Value: 10
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
Value: 11
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

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header certenroll.h

See also

CertEnroll Enumerations

CertEnroll Interfaces

IAlternativeName

IX509ExtensionAlternativeNames