Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
You can use the IX500DistinguishedName interface to create a subject name from a distinguished name string. The string consists of concatenated relative distinguished names (RDNs). The following RDN keys are supported by the Certificate Enrollment API.
Key | OID | Description |
---|---|---|
C |
XCN_OID_COUNTRY_NAME |
Contains a two-letter ISO 3166 country or region code. |
CN |
XCN_OID_COMMON_NAME |
Contains a common name. |
E |
XCN_OID_RSA_emailAddr |
Contains an email address. |
DC |
XCN_OID_DOMAIN_COMPONENT |
Contains one part of a Domain Name System (DNS) name. |
G GivenName |
XCN_OID_GIVEN_NAME |
Contains the part of a person's name that is not a surname. |
I |
XCN_OID_INITIALS |
Contains a person's initials. |
L |
XCN_OID_LOCALITY_NAME |
Contains the locality name that identifies a city, country, or other geographic region. |
O |
XCN_OID_ORGANIZATION_NAME |
Contains the name of an organization. |
OU |
XCN_OID_ORGANIZATIONAL_UNIT_NAME |
Contains the name of a unit subdivision within an organization. |
S ST |
XCN_OID_STATE_OR_PROVINCE_NAME |
Contains the full name of a state or province. |
STREET |
XCN_OID_STREET_ADDRESS |
Contains the physical address. |
SN |
XCN_OID_SUR_NAME |
Contains the family name of a person. |
T TITLE |
XCN_OID_TITLE |
Contains the title of a person in the organization. |
When you initialize an IX500DistinguishedName object, you can identify the format of the distinguished name by specifying a value from the X500NameFlags enumeration type. For example, assume that the subject distinguished name consists of the following RDNs:
- CN=Administrator
CN=Users
DC=jdomcsc
DC=nttest
DC=microsoft
DC=com
If you concatenate these RDNs into the following comma-delimited distinguished name string, you can specify the XCN_CERT_NAME_STR_COMMA_FLAG value when initializing an IX500DistinguishedName object.
CN=Administrator,CN=Users,DC=jdomcsc,DC=nttest,DC=microsoft,DC=com