共用方式為

X500NameFlags 列舉 （certenroll.h）

  • 發行項

X500NameFlags 列舉類型會指定辨別名稱或 相對辨別名稱 的顯示和 編碼 特性。 此列舉可用來初始化 IX500DistinguishedName 物件。

語法

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 包含開頭或尾端空格元或下列其中一個字元，則 RDN 會以引號 （“ ”） 括住：

  • 逗號 （，）

  • 加號 （+）

  • 等號 （=）

  • 英吋標記 （“）

  • 線條摘要（\n）

  • 小於符號 （<）

  • 大於符號 （>）

  • 數字符號 （#）

  • 分號 （;)

  • 內嵌引號 （“）
XCN_CERT_XML_NAME_STR
值：4
OID 的處理方式與用來轉換XCN_CERT_X500_NAME_ST值的方式相同，不同之處在於它們會格式化為 XML 元素序列。 如下列範例所示：



              <CN>cart.contoso.com</CN>

              <OU>www.verisign.com/rpa （c）00</OU>

              <OU rDNAttribute=“true”>IT 作業</OU>

              <O>Contoso.com</O>

              <L>紐約</L>

              <S>紐約</S>

              <C>US</C>

              <RDN oid=“1.2.3.4” type=“string”>name</RDN>

              <RDN rDNAttribute=“true” oid=“1.2.1.3” type=“encoded”>0500</RDN>

              <RDN oid=“1.2.1.4” type=“encoded”>020135</RDN>

              <RDN oid=“1.2.2.5.3” type=“octet”>01FF7F</RDN>


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 顯示順序是 CN=name,..., DC=com。 使用此旗標將編碼順序變更為 DC=com,..., CN=名稱。 除非您指定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
包含 Unicode 字元的字串會轉碼為 Punycode，這是用於因特網主機名的有限 ASCII 字元子集。 這個 ASCII 字元的子集是由字母、數位和連字元所組成。
XCN_CERT_NAME_STR_DS_ESCAPED
值：0x800000
逸出辨別名稱中不允許的字元（DN）。

要求

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

另請參閱

CertEnroll 列舉

CertEnroll 介面

IX500DistinguishedName