Bagikan melalui


Enumerasi X500NameFlags (certenroll.h)

Jenis enumerasi X500NameFlags menentukan karakteristik tampilan dan pengodean dari nama khusus atau nama khusus relatif (RDN). Enumerasi ini digunakan untuk menginisialisasi objek IX500DistinguishedName .

Sintaks

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

Konstanta

 
XCN_CERT_NAME_STR_NONE
Nilai: 0
Karakteristik tampilan tidak diidentifikasi.
XCN_CERT_SIMPLE_NAME_STR
Nilai: 1
Semua pengidentifikasi objek (OID) dibuang. Nama khusus relatif (RDN) dipisahkan oleh koma diikuti oleh spasi (, ). Atribut RDN dipisahkan oleh tanda plus yang diapit dalam spasi ( + ).
XCN_CERT_OID_NAME_STR
Nilai: 2
OID dipisahkan dari nilai atribut terkait dengan menggunakan tanda sama dengan (=). RDN dipisahkan oleh koma diikuti dengan spasi (, ). Atribut RDN dipisahkan oleh tanda plus diikuti dengan spasi (+ ).
XCN_CERT_X500_NAME_STR
Nilai: 3
OID dikonversi ke nama kunci X.500 mereka. Mereka dipisahkan dari nilai atribut terkait dengan menggunakan tanda sama dengan (=). RDN dipisahkan oleh koma diikuti dengan spasi (, ). Atribut RDN dipisahkan oleh tanda plus diikuti dengan spasi (+ ).

Jika OID tidak memiliki nama X.500 yang sesuai, OID digunakan dengan awalan OID. RDN diapit dalam tanda kutip (" ") jika berisi spasi putih di depan atau di belakang atau salah satu karakter berikut:

  • Koma (,)

  • Tanda plus (+)

  • Tanda sama dengan (=)

  • Tanda inci (")

  • Umpan baris (\n)

  • Kurang dari tanda (<)

  • Lebih besar dari tanda (>)

  • Tanda angka (#)

  • Titik koma (;)

  • Tanda kutip tersemat (")

XCN_CERT_XML_NAME_STR
Nilai: 4
OID diperlakukan dengan cara yang sama seperti yang digunakan untuk mengonversi nilai XCN_CERT_X500_NAME_ST kecuali diformat sebagai urutan elemen XML. Hal ini ditunjukkan di contoh berikut.


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>

Karakter markup XML Unicode diloloskan dengan cara berikut. Karakter yang lebih besar dari 0x7F diloloskan dengan menggunakan referensi karakter (L"&#xXXXX;").

  • & menjadi L"&"

  • < menjadi L"<"

  • > menjadi L">"

  • ' menjadi L"'"

  • " menjadi L"""

XCN_CERT_NAME_STR_SEMICOLON_FLAG
Nilai: 0x40000000
Pemisah koma (,) yang digunakan antara RDN diganti dengan titik koma (karakter ;).
XCN_CERT_NAME_STR_NO_PLUS_FLAG
Nilai: 0x20000000
Pemisah (+) yang digunakan antara atribut RDN diganti dengan satu karakter spasi.
XCN_CERT_NAME_STR_NO_QUOTING_FLAG
Nilai: 0x10000000
Menghambat penggunaan tanda kutip untuk nilai XCN_CERT_X500_NAME_ST.
XCN_CERT_NAME_STR_CRLF_FLAG
Nilai: 0x8000000
Pemisah koma (,) yang digunakan antara RDN diganti dengan urutan pengembalian pengangkutan/umpan baris (\r\n).
XCN_CERT_NAME_STR_COMMA_FLAG
Nilai: 0x4000000
Menentukan bahwa pemisah antara RDN adalah koma (,).
XCN_CERT_NAME_STR_REVERSE_FLAG
Nilai: 0x2000000
Menentukan bahwa urutan RDN yang membentuk nama khusus (DN) dibalik untuk pengodean. Urutan tampilan DN yang khas adalah CN=name,...,DC=com. Gunakan bendera ini untuk mengubah urutan pengodean menjadi DC=com,...,CN=name. Objek IX500DistinguishedName mengatur bendera ini secara default kecuali Anda menentukan XCN_CERT_NAME_STR_FORWARD_FLAG.
XCN_CERT_NAME_STR_FORWARD_FLAG
Nilai: 0x1000000
Gunakan untuk membatalkan urutan pengodean yang ditentukan dengan mengatur nilai XCN_CERT_NAME_STR_REVERSE_FLAG.
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG
Nilai: 0x10000
Melewati upaya awal untuk mendekode nilai karakter T.61 Teletex ke nilai UTF-8. Secara default, nilai T.61 awalnya didekodekan ke UTF-8, tetapi jika dekode UTF-8 gagal, nilai didekodekan sebagai karakter 8-bit.
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG
Nilai: 0x20000
T.61 digunakan daripada pengodean karakter Unicode untuk semua karakter kurang dari 0xFF. LDAP, misalnya, menggunakan T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG
Nilai: 0x40000
UTF-8 digunakan untuk DN alih-alih pengodean karakter Unicode.
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
Nilai: 0x80000
Memaksa kunci X.500 berikut untuk dikodekan sebagai string UTF-8 daripada string Unicode yang dapat dicetak.


































































KunciOID
CNXCN_OID_COMMON_NAME
GXCN_OID_GIVEN_NAME
GivenNameXCN_OID_GIVEN_NAME
GNXCN_OID_GIVEN_NAME
IXCN_OID_INITIALS
InitialsXCN_OID_INITIALS
LXCN_OID_LOCALITY_NAME
OXCN_ORGANIZATION_NAME
OUXCN_OID_ORGANIZATIONAL_UNIT_NAME
SXCN_OID_STATE_OR_PROVINCE_NAME
SNXCN_ID_SUR_NAME
STXCN_OID_STATE_OR_PROVINCE_NAME
STREETXCN_OID_STREET_ADDRESS
TXCN_OID_TITLE
JudulXCN_OID_TITLE
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG
Nilai: 0x100000
Mencegah memaksa string Unicode yang dapat dicetak untuk dikodekan dengan menggunakan UTF-8. Gunakan jika diinginkan saat XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG adalah perilaku default.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG
Nilai: 0x200000
XCN_CERT_NAME_STR_DS_ESCAPED
Nilai: 0x800000

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header certenroll.h

Lihat juga

Enumerasi CertEnroll

Antarmuka CertEnroll

IX500DistinguishedName