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_NONEWert: 0 Anzeigemerkmale werden nicht identifiziert. |
XCN_CERT_SIMPLE_NAME_STRWert: 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_STRWert: 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_STRWert: 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:
|
XCN_CERT_XML_NAME_STRWert: 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: 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.
|
XCN_CERT_NAME_STR_SEMICOLON_FLAGWert: 0x40000000 Das zwischen RDNs verwendete Kommatrennzeichen (,) wird durch ein Semikolon (;) Zeichen) ersetzt. |
XCN_CERT_NAME_STR_NO_PLUS_FLAGWert: 0x20000000 Das zwischen RDN-Attributen verwendete Trennzeichen (+) wird durch ein einzelnes Leerzeichen ersetzt. |
XCN_CERT_NAME_STR_NO_QUOTING_FLAGWert: 0x10000000 Hemmt die Verwendung von Anführungszeichen für den XCN_CERT_X500_NAME_ST Wert. |
XCN_CERT_NAME_STR_CRLF_FLAGWert: 0x8000000 Das zwischen RDNs verwendete Kommatrennzeichen (,) wird durch eine Wagenrücklauf-/Zeilenvorschubsequenz (\r\n) ersetzt. |
XCN_CERT_NAME_STR_COMMA_FLAGWert: 0x4000000 Gibt an, dass das Trennzeichen zwischen RDNs ein Komma (,) ist. |
XCN_CERT_NAME_STR_REVERSE_FLAGWert: 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_FLAGWert: 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_FLAGWert: 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_FLAGWert: 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_FLAGWert: 0x40000 UTF-8 wird anstelle der Unicode-Zeichencodierung für den distinguished Name (DN) verwendet. |
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAGWert: 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).
|
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAGWert: 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_FLAGWert: 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_ESCAPEDWert: 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 |