Bagikan melalui


Enumerasi X500NameFlags (certenroll.h)

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

Sintaksis

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 dengan 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 nomor (#)

  • Titik koma (;)

  • Tanda kutip yang disematkan (")

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. Ini ditunjukkan dalam contoh berikut:


<CN>cart.contoso.com</CN>
<Ketentuan penggunaan>unit organisasi pada>www.verisign.com/rpa (c)00</OU
<OU rDNAttribute="true">Operasi IT</OU>
< > O>Contoso.com</O
<L></L> New York
> <S>New York</S
<C><AS /C>
<RDN oid="1.2.3.4" type="string" nama></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>


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 di antara atribut RDN diganti dengan karakter spasi tunggal.
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 return/line feed (\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= nama,...,DC=com. Gunakan bendera ini untuk mengubah urutan pengodean ke DC=com,...,CN= nama. 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
Melompati 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 nama khusus (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. Berikut ini adalah daftar kunci dan pengidentifikasi objek (OID) yang sesuai.


  • CN - XCN_OID_COMMON_NAME

  • G - XCN_OID_GIVEN_NAME

  • GivenName - XCN_OID_GIVEN_NAME

  • GN - XCN_OID_GIVEN_NAME

  • I - XCN_OID_INITIALS

  • Inisial - XCN_OID_INITIALS

  • L - XCN_OID_LOCALITY_NAME

  • O - XCN_ORGANIZATION_NAME

  • Unit Organisasi - 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

  • Judul - XCN_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
String yang berisi karakter Unicode ditranskodekan ke Punycode, subset karakter ASCII terbatas yang digunakan untuk nama host Internet. Subset karakter ASCII ini terdiri dari huruf, digit, dan tanda hubung.
XCN_CERT_NAME_STR_DS_ESCAPED
Nilai: 0x800000
Karakter escape yang tidak diperbolehkan dalam nama khusus (DN).

Persyaratan

Syarat 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

CertEnroll Interfaces

IX500DistinguishedName