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.
The X500NameFlags enumeration type specifies the display and encoding characteristics of a distinguished name or relative distinguished name (RDN). This enumeration is used to initialize an IX500DistinguishedName object.
Syntax
typedef enum X500NameFlags {
XCN_CERT_NAME_STR_NONE = 0,
XCN_CERT_SIMPLE_NAME_STR = 1,
XCN_CERT_OID_NAME_STR = 2,
XCN_CERT_X500_NAME_STR = 3,
XCN_CERT_XML_NAME_STR = 4,
XCN_CERT_NAME_STR_SEMICOLON_FLAG = 0x40000000,
XCN_CERT_NAME_STR_NO_PLUS_FLAG = 0x20000000,
XCN_CERT_NAME_STR_NO_QUOTING_FLAG = 0x10000000,
XCN_CERT_NAME_STR_CRLF_FLAG = 0x8000000,
XCN_CERT_NAME_STR_COMMA_FLAG = 0x4000000,
XCN_CERT_NAME_STR_REVERSE_FLAG = 0x2000000,
XCN_CERT_NAME_STR_FORWARD_FLAG = 0x1000000,
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS,
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG = 0x10000,
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG = 0x20000,
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG = 0x40000,
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG = 0x80000,
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG = 0x100000,
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG = 0x200000,
XCN_CERT_NAME_STR_DS_ESCAPED = 0x800000
} ;
Constants
XCN_CERT_NAME_STR_NONEValue: 0 Display characteristics are not identified. |
XCN_CERT_SIMPLE_NAME_STRValue: 1 All object identifiers (OIDs) are discarded. Relative distinguished names (RDNs) are separated by commas followed by a space (, ). RDN attributes are separated by a plus sign enclosed within spaces ( + ). |
XCN_CERT_OID_NAME_STRValue: 2 OIDs are separated from their associated attribute value by using an equal sign (=). RDNs are separated by a comma followed by a space (, ). RDN attributes are separated by a plus sign followed by a space (+ ). |
XCN_CERT_X500_NAME_STRValue: 3 OIDs are converted to their X.500 key names. They are separated from their associated attribute value by using an equal sign (=). RDNs are separated by a comma followed by a space (, ). RDN attributes are separated by a plus sign followed by a space (+ ). If an OID does not have a corresponding X.500 name, the OID is used with a prefix of OID. The RDN is enclosed within quotation marks (" ") if it contains leading or trailing white space or one of the following characters:
|
XCN_CERT_XML_NAME_STRValue: 4 OIDs are treated in the same manner as that used to convert XCN_CERT_X500_NAME_ST values except that they are formatted as a sequence of XML elements. This is shown in the following example: The Unicode XML markup characters are escaped in the following manner. Characters greater than 0x7F are escaped by using character references (L"&#xXXXX;").
|
XCN_CERT_NAME_STR_SEMICOLON_FLAGValue: 0x40000000 The comma (,) separator used between RDNs is replaced with a semicolon (;) character. |
XCN_CERT_NAME_STR_NO_PLUS_FLAGValue: 0x20000000 The (+) separator used between RDN attributes is replaced with a single space character. |
XCN_CERT_NAME_STR_NO_QUOTING_FLAGValue: 0x10000000 Inhibits the use of quotation marks for the XCN_CERT_X500_NAME_ST value. |
XCN_CERT_NAME_STR_CRLF_FLAGValue: 0x8000000 The comma (,) separator used between RDNs is replaced with a carriage return/line feed (\r\n) sequence. |
XCN_CERT_NAME_STR_COMMA_FLAGValue: 0x4000000 Specifies that the separator between RDNs is a comma (,). |
XCN_CERT_NAME_STR_REVERSE_FLAGValue: 0x2000000 Specifies that the order of the RDNs that make up the distinguished name (DN) is reversed for encoding. The typical DN display order is CN=name,...,DC=com. Use this flag to change the encoding order to DC=com,...,CN=name. An IX500DistinguishedName object sets this flag by default unless you specify XCN_CERT_NAME_STR_FORWARD_FLAG. |
XCN_CERT_NAME_STR_FORWARD_FLAGValue: 0x1000000 Use to undo the encoding order specified by setting the XCN_CERT_NAME_STR_REVERSE_FLAG value. |
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS |
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAGValue: 0x10000 Skips the initial attempt to decode T.61 Teletex character values to UTF-8 values. By default, T.61 values are initially decoded to UTF-8, but if UTF-8 decoding fails, the values are decoded as 8-bit characters. |
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAGValue: 0x20000 T.61 is used rather than Unicode character encoding for all characters less than 0xFF. LDAP, for example, uses T.61. |
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAGValue: 0x40000 UTF-8 is used for the distinguished name (DN) instead of Unicode character encoding. |
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAGValue: 0x80000 Forces the following X.500 keys to be encoded as UTF-8 strings rather than printable Unicode strings. The following is the list of the keys and their corresponding object identifiers (OIDs).
|
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAGValue: 0x100000 Prevents forcing printable Unicode strings to be encoded by using UTF-8. Use when desired when XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG is the default behavior. |
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAGValue: 0x200000 Strings containing Unicode characters are transcoded to Punycode, a limited ASCII character subset that's used for Internet hostnames. This subset of ASCII characters consists of letters, digits, and hyphens. |
XCN_CERT_NAME_STR_DS_ESCAPEDValue: 0x800000 Escapes characters that are not allowed in distinguished names (DNs). |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Header | certenroll.h |