X500NameFlags 列舉 (certenroll.h)

X500NameFlags 列舉類型會指定辨別名稱或相對辨別名稱的顯示和編碼特性， (RDN) 。 這個列舉是用來初始化 IX500DistinguishedName 物件。

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
} ;

常數

XCN_CERT_NAME_STR_NONE 值： 0 不會識別顯示特性。
XCN_CERT_SIMPLE_NAME_STR 值： 1 捨棄所有 物件標識碼 (OID) 。 (RDN) 的相對辨別名稱會以逗號分隔，後面接著空格 (，) 。 RDN 屬性會以加號分隔，以空格括住 ( + ) 。
XCN_CERT_OID_NAME_STR 值： 2 OID 會使用等號 (=) 來分隔其相關聯的屬性值。 RDN 會以逗號分隔，後面接著空格 (，) 。 RDN 屬性會以加號分隔，後面接著空格 (+ ) 。
XCN_CERT_X500_NAME_STR 值： 3 OID 會轉換成其 X.500 索引鍵名稱。 它們會使用等號 (=) 來分隔其相關聯的屬性值。 RDN 會以逗號分隔，後面接著空格 (，) 。 RDN 屬性會以加號分隔，後面接著空格 (+ ) 。 如果 OID 沒有對應的 X.500 名稱，OID 會搭配 OID 前置詞使用。 如果 RDN 包含開頭或尾端空格符或下列其中一個字元，則以引弧括住 (“ ”) ： 逗號 (,) 加號 (+) 等號 (=) 英吋標記 (“) 換行字元 (\n) 小於符號 () < 大於符號 (>) 數字符號 (#) 分號 (;) 內嵌引號 (“)
XCN_CERT_XML_NAME_STR 值： 4 OID 的處理方式與用來轉換XCN_CERT_X500_NAME_ST值的方式相同，不同之處在於它們會格式化為 XML 元素序列。 下列範例會顯示這一點。 syntax<br><br>&lt;CN&gt;cart.contoso.com&lt;/CN&gt;<br>&lt;OU&gt;Terms of use at www.verisign.com/rpa (c)00&lt;/OU&gt;<br>&lt;OU rDNAttribute="true"&gt;IT Operations&lt;/OU&gt;<br>&lt;O&gt;Contoso.com&lt;/O&gt;<br>&lt;L&gt;New York&lt;/L&gt;<br>&lt;S&gt;New York&lt;/S&gt;<br>&lt;C&gt;US&lt;/C&gt;<br>&lt;RDN oid="1.2.3.4" type="string"&gt;name&lt;/RDN&gt;<br>&lt;RDN rDNAttribute="true" oid="1.2.1.3" type="encoded"&gt;0500&lt;/RDN&gt;<br>&lt;RDN oid="1.2.1.4" type="encoded"&gt;020135&lt;/RDN&gt;<br>&lt;RDN oid="1.2.2.5.3" type="octet"&gt;01FF7F&lt;/RDN&gt;<br> Unicode XML 標記字元會以下列方式逸出。 大於0x7F的字元會使用 L“&#xXXXX;”) (字元參考來逸出。 & 變成 L“&” < 變成 L“<” > 變成 L“>” ' 變成 L“'” “ 變成 L”"”
XCN_CERT_NAME_STR_SEMICOLON_FLAG 值： 0x40000000 RDN 之間使用的逗號 (，) 分隔符會取代為分號 (;) 字元。
XCN_CERT_NAME_STR_NO_PLUS_FLAG 值： 0x20000000 RDN 屬性之間所使用的 (+) 分隔符會取代為單一空格字元。
XCN_CERT_NAME_STR_NO_QUOTING_FLAG 值： 0x10000000 禁止對XCN_CERT_X500_NAME_ST值使用引號。
XCN_CERT_NAME_STR_CRLF_FLAG 值： 0x8000000 RDN 之間使用的逗號 (，) 分隔符會取代為歸位字元/換行字元 (\r\n) 序列。
XCN_CERT_NAME_STR_COMMA_FLAG 值： 0x4000000 指定 RDN 之間的分隔符是逗號 (，) 。
XCN_CERT_NAME_STR_REVERSE_FLAG 值： 0x2000000 指定組成辨別名稱的 RDN 順序， (DN) 進行編碼。 典型的 DN 顯示順序是 CN=name,...,DC=com。 使用此旗標將編碼順序變更為DC=com,...,CN=name。 除非您指定XCN_CERT_NAME_STR_FORWARD_FLAG， 否則 IX500DistinguishedName 物件預設會設定此旗標。
XCN_CERT_NAME_STR_FORWARD_FLAG 值： 0x1000000 使用 來復原藉由設定XCN_CERT_NAME_STR_REVERSE_FLAG值所指定的編碼順序。
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG 值： 0x10000 略過將 T.61 Teletex 字元值譯碼為 UTF-8 值的初始嘗試。 根據預設，T.61 值一開始會譯碼為 UTF-8，但如果 UTF-8 譯碼失敗，則會將值譯碼為 8 位字元。
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG 值： 0x20000 T.61 是針對小於 0xFF 的所有字元使用，而不是 Unicode 字元編碼。 例如，LDAP 會使用 T.61。
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG 值： 0x40000 UTF-8 用於 DN，而不是 Unicode 字元編碼。
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG 值： 0x80000 強制下列 X.500 鍵編碼為 UTF-8 字串，而不是可列印的 Unicode 字串。 答案 OID CN XCN_OID_COMMON_NAME G XCN_OID_GIVEN_NAME GivenName XCN_OID_GIVEN_NAME GN XCN_OID_GIVEN_NAME I XCN_OID_INITIALS 縮寫 XCN_OID_INITIALS L XCN_OID_LOCALITY_NAME O XCN_ORGANIZATION_NAME OU XCN_OID_ORGANIZATIONAL_UNIT_NAME S XCN_OID_STATE_OR_PROVINCE_NAME SN XCN_ID_SUR_NAME ST XCN_OID_STATE_OR_PROVINCE_NAME STREET XCN_OID_STREET_ADDRESS T XCN_OID_TITLE 標題 XCN_OID_TITLE
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG 值： 0x100000 防止強制使用UTF-8編碼可列印的Unicode字串。 當XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG是預設行為時，請使用 。
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG 值： 0x200000
XCN_CERT_NAME_STR_DS_ESCAPED 值： 0x800000

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	certenroll.h

另請參閱

CertEnroll 列舉

CertEnroll 介面

IX500DistinguishedName