X500NameFlags 列挙 (certenroll.h)

X500NameFlags 列挙型は、識別名または相対識別名 (RDN) の表示および エンコード 特性 指定します。 この列挙型は、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 は、先頭または末尾の空白または次のいずれかの文字が含まれている場合、引用符 (" ") で囲まれます。

  • コンマ (,)

  • プラス記号 (+)

  • 等号 (=)

  • インチ マーク (")

  • 改行 (\n)

  • 符号より小さい (<)

  • より大きい記号 (>)

  • 番号記号 (#)

  • セミコロン (;)

  • 埋め込み引用符 (")

XCN_CERT_XML_NAME_STR
値: 4
OID は、XML 要素のシーケンスとして書式設定される点を除き、XCN_CERT_X500_NAME_ST値の変換に使用されるのと同じ方法で扱われます。 これを次の例に示します。


<CN>cart.contoso.com</CN>
<OU>使用条件 (www.verisign.com/rpa (c)00</OU>
<OU rDNAttribute="true">IT Operations</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 属性間で使用される (+) 区切り記号は、1 つのスペース文字に置き換えられます。
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
識別名 (DN) を構成する RDN の順序が、エンコードのために逆になるように指定します。 一般的な DN 表示順序は CN=,..., DC=comです。 このフラグを使用して、エンコード順序を DC=com,..., CN=に変更します。 IX500DistinguishedName オブジェクトは、XCN_CERT_NAME_STR_FORWARD_FLAGを指定しない限り、既定でこのフラグを設定します。
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 は、Unicode 文字エンコードの代わりに識別名 (DN) に使用されます。
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
値: 0x80000
印刷可能な Unicode 文字列ではなく、次の X.500 キーを UTF-8 文字列としてエンコードするように強制します。 キーとそれに対応するオブジェクト識別子 (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 文字を含む文字列は、インターネット ホスト名に使用される制限付き ASCII 文字サブセットである Punycode にトランスコードされます。 この ASCII 文字のサブセットは、文字、数字、ハイフンで構成されます。
XCN_CERT_NAME_STR_DS_ESCAPED
値: 0x800000
識別名 (DN) で使用できない文字をエスケープします。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー certenroll.h

関連項目

CertEnroll 列挙

CertEnroll インターフェイスの

IX500DistinguishedName