Freigeben über

X500NameFlags-Aufzählung (certenroll.h)

Der X500NameFlags- Enumerationstyp gibt die Anzeige und Codierung Merkmale eines distinguishierten Namens oder relativen Distinguished Name (RDN) an. Diese Aufzählung wird verwendet, um ein IX500DistinguishedName-Objekt zu initialisieren.

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

Konstanten

 
XCN_CERT_NAME_STR_NONE
Wert: 0
Anzeigemerkmale werden nicht identifiziert.
XCN_CERT_SIMPLE_NAME_STR
Wert: 1
Alle Objektbezeichner (OIDs) werden verworfen. Relative Distinguished Names (RDNs) werden durch Kommas gefolgt von einem Leerzeichen (, ) getrennt. RDN-Attribute werden durch ein Pluszeichen getrennt, das in Leerzeichen ( + ) eingeschlossen ist.
XCN_CERT_OID_NAME_STR
Wert: 2
OIDs werden durch ein Gleichheitszeichen (=) vom zugeordneten Attributwert getrennt. RDNs werden durch ein Komma getrennt, gefolgt von einem Leerzeichen (, ). RDN-Attribute werden durch ein Pluszeichen getrennt, gefolgt von einem Leerzeichen (+).
XCN_CERT_X500_NAME_STR
Wert: 3
OIDs werden in ihre X.500- Schlüsselnamen konvertiert. Sie werden durch ein Gleichheitszeichen (=) von ihrem zugeordneten Attributwert getrennt. RDNs werden durch ein Komma getrennt, gefolgt von einem Leerzeichen (, ). RDN-Attribute werden durch ein Pluszeichen getrennt, gefolgt von einem Leerzeichen (+).

Wenn ein OID keinen entsprechenden X.500-Namen hat, wird das OID mit einem Präfix von OID verwendet. Das RDN wird in Anführungszeichen (" ") eingeschlossen, wenn er führende oder nachfolgende Leerzeichen oder eines der folgenden Zeichen enthält:

  • Komma (,)

  • Pluszeichen (+)

  • Gleichheitszeichen (=)

  • Zollzeichen (")

  • Zeilenvorschub (\n)

  • Kleiner als Zeichen (<)

  • Größer als Zeichen (>)

  • Nummernzeichen (#)

  • Semikolon (;)

  • Eingebettetes Anführungszeichen (")
XCN_CERT_XML_NAME_STR
Wert: 4
OIDs werden auf die gleiche Weise behandelt wie beim Konvertieren von XCN_CERT_X500_NAME_ST Werten, mit der Ausnahme, dass sie als Sequenz von XML-Elementen formatiert sind. Dies wird im folgenden Beispiel gezeigt:



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

              <OU>Nutzungsbedingungen bei www.verisign.com/rpa (c)00</OU>

              <OU rDNAttribute="true">IT Operations</OU>

              <O>Contoso.com</O>

              <L>New York</L>

              <S>New York</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>


Die Unicode-XML-Markupzeichen werden wie folgt mit Escapezeichen versehen. Zeichen, die größer als 0x7F sind, werden mithilfe von Zeichenbezügen (L"&#xXXXX;") escapen.


  • & wird L"&"

  • < wird L"<"

  • > wird L">"

  • ' wird L"'"

  • "wird L"""
XCN_CERT_NAME_STR_SEMICOLON_FLAG
Wert: 0x40000000
Das zwischen RDNs verwendete Kommatrennzeichen (,) wird durch ein Semikolon (;) Zeichen) ersetzt.
XCN_CERT_NAME_STR_NO_PLUS_FLAG
Wert: 0x20000000
Das zwischen RDN-Attributen verwendete Trennzeichen (+) wird durch ein einzelnes Leerzeichen ersetzt.
XCN_CERT_NAME_STR_NO_QUOTING_FLAG
Wert: 0x10000000
Hemmt die Verwendung von Anführungszeichen für den XCN_CERT_X500_NAME_ST Wert.
XCN_CERT_NAME_STR_CRLF_FLAG
Wert: 0x8000000
Das zwischen RDNs verwendete Kommatrennzeichen (,) wird durch eine Wagenrücklauf-/Zeilenvorschubsequenz (\r\n) ersetzt.
XCN_CERT_NAME_STR_COMMA_FLAG
Wert: 0x4000000
Gibt an, dass das Trennzeichen zwischen RDNs ein Komma (,) ist.
XCN_CERT_NAME_STR_REVERSE_FLAG
Wert: 0x2000000
Gibt an, dass die Reihenfolge der RDNs, aus denen der Distinguished Name (DN) besteht, für die Codierung umgekehrt wird. Die typische DN-Anzeigereihenfolge ist CN=Name,...,DC=com. Verwenden Sie dieses Kennzeichen, um die Codierungsreihenfolge in DC=com,...,CN=Namezu ändern. Ein IX500DistinguishedName Objekt legt dieses Flag standardmäßig fest, es sei denn, Sie geben XCN_CERT_NAME_STR_FORWARD_FLAG an.
XCN_CERT_NAME_STR_FORWARD_FLAG
Wert: 0x1000000
Wird verwendet, um die durch Festlegen des werts XCN_CERT_NAME_STR_REVERSE_FLAG angegebene Codierungsreihenfolge rückgängig zu machen.
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG
Wert: 0x10000
Überspringt den anfänglichen Versuch, T.61 Teletex-Zeichenwerte in UTF-8-Werte zu decodieren. T.61-Werte werden standardmäßig anfänglich mit UTF-8 decodiert, aber wenn UTF-8-Decodierung fehlschlägt, werden die Werte als 8-Bit-Zeichen decodiert.
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG
Wert: 0x20000
T.61 wird anstelle der Unicode-Zeichencodierung für alle Zeichen verwendet, die kleiner als 0xFF sind. LDAP verwendet z. B. T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG
Wert: 0x40000
UTF-8 wird anstelle der Unicode-Zeichencodierung für den distinguished Name (DN) verwendet.
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
Wert: 0x80000
Erzwingt, dass die folgenden X.500-Schlüssel nicht als druckbare Unicode-Zeichenfolgen, sondern als UTF-8-Zeichenfolgen codiert werden. Es folgt die Liste der Schlüssel und deren entsprechenden Objektbezeichner (OIDs).


  • CN - XCN_OID_COMMON_NAME

  • G - XCN_OID_GIVEN_NAME

  • GivenName - XCN_OID_GIVEN_NAME

  • GN - XCN_OID_GIVEN_NAME

  • I - XCN_OID_INITIALS

  • Initialen - 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

  • Titel - XCN_OID_TITLE
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG
Wert: 0x100000
Verhindert, dass druckbare Unicode-Zeichenfolgen mithilfe von UTF-8 codiert werden. Wird bei Bedarf verwendet, wenn XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG das Standardverhalten ist.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG
Wert: 0x200000
Zeichenfolgen, die Unicode-Zeichen enthalten, werden in Punycode transcodiert, eine begrenzte ASCII-Zeichenuntermenge, die für Internethosts verwendet wird. Diese Teilmenge von ASCII-Zeichen besteht aus Buchstaben, Ziffern und Bindestrichen.
XCN_CERT_NAME_STR_DS_ESCAPED
Wert: 0x800000
Escapezeichen, die in Distinguished Names (DNs) nicht zulässig sind.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Header- certenroll.h

Siehe auch

CertEnroll-Enumerationen

CertEnroll-Schnittstellen

IX500DistinguishedName

  • Last updated on