X500NameFlags, énumération (certenroll.h)

  • Article

Le type d’énumération X500NameFlags spécifie les caractéristiques d’affichage et d’encodage d’un nom unique ou d’un nom unique relatif (RDN). Cette énumération est utilisée pour initialiser un objet IX500DistinguishedName .

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

Constantes

 
XCN_CERT_NAME_STR_NONE
Valeur : 0
Les caractéristiques d’affichage ne sont pas identifiées.
XCN_CERT_SIMPLE_NAME_STR
Valeur : 1
Tous les identificateurs d’objets (OID) sont ignorés. Les noms uniques relatifs (RDN) sont séparés par des virgules suivies d’un espace (, ). Les attributs RDN sont séparés par un signe plus placé dans des espaces ( + ).
XCN_CERT_OID_NAME_STR
Valeur : 2
Les OID sont séparés de leur valeur d’attribut associée à l’aide d’un signe égal (=). Les RDN sont séparés par une virgule suivie d’un espace (, ). Les attributs RDN sont séparés par un signe plus suivi d’un espace (+ ).
XCN_CERT_X500_NAME_STR
Valeur : 3
Les OID sont convertis en noms de clés X.500 . Ils sont séparés de leur valeur d’attribut associée à l’aide d’un signe égal (=). Les RDN sont séparés par une virgule suivie d’un espace (, ). Les attributs RDN sont séparés par un signe plus suivi d’un espace (+ ).

Si un OID n’a pas de nom X.500 correspondant, l’OID est utilisé avec un préfixe d’OID. Le RDN est placé entre guillemets ( » « ) s’il contient des espaces blancs de début ou de fin ou l’un des caractères suivants :

  • Virgule (,)

  • Signe plus (+)

  • Le signe égal (=)

  • Marque pouce (« )

  • Flux de ligne (\n)

  • Inférieur au signe (<)

  • Supérieur au signe (>)

  • Signe numérique (#)

  • Point-virgule (;)

  • Guillemet incorporé (« )
XCN_CERT_XML_NAME_STR
Valeur : 4
Les OID sont traités de la même manière que ceux utilisés pour convertir XCN_CERT_X500_NAME_ST valeurs, sauf qu’ils sont mis en forme en tant que séquence d’éléments XML. Cela est illustré par l'exemple suivant.


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>

Les caractères de balisage XML Unicode sont placés dans une séquence d’échappement de la manière suivante. Les caractères supérieurs à 0x7F sont placés dans une séquence d’échappement à l’aide de références de caractères (L"&#xXXXX; »).

  • & devient L"& ; »

  • < devient L"< ; »

  • > devient L"> ; »

  • ' devient L"&apos ; »

  • « devient L"" ; »
XCN_CERT_NAME_STR_SEMICOLON_FLAG
Valeur : 0x40000000
Le séparateur de virgules (,) utilisé entre les RDN est remplacé par un point-virgule (;) caractère).
XCN_CERT_NAME_STR_NO_PLUS_FLAG
Valeur : 0x20000000
Le séparateur (+) utilisé entre les attributs RDN est remplacé par un seul caractère d’espace.
XCN_CERT_NAME_STR_NO_QUOTING_FLAG
Valeur : 0x10000000
Empêche l’utilisation de guillemets pour la valeur XCN_CERT_X500_NAME_ST.
XCN_CERT_NAME_STR_CRLF_FLAG
Valeur : 0x8000000
Le séparateur de virgules (,) utilisé entre les RDN est remplacé par une séquence de retour chariot/flux de ligne (\r\n).
XCN_CERT_NAME_STR_COMMA_FLAG
Valeur : 0x4000000
Spécifie que le séparateur entre rdn est une virgule (,).
XCN_CERT_NAME_STR_REVERSE_FLAG
Valeur : 0x2000000
Spécifie que l’ordre des RDN qui composent le nom unique (DN) est inversé pour l’encodage. L’ordre d’affichage DN classique est CN=name,...,DC=com. Utilisez cet indicateur pour modifier l’ordre d’encodage sur DC=com,...,CN=name. Un objet IX500DistinguishedName définit cet indicateur par défaut, sauf si vous spécifiez XCN_CERT_NAME_STR_FORWARD_FLAG.
XCN_CERT_NAME_STR_FORWARD_FLAG
Valeur : 0x1000000
Utilisez pour annuler l’ordre d’encodage spécifié en définissant la valeur XCN_CERT_NAME_STR_REVERSE_FLAG.
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG
Valeur : 0x10000
Ignore la tentative initiale de décodage des valeurs de caractères T.61 Teletex en valeurs UTF-8. Par défaut, les valeurs T.61 sont initialement décodées en UTF-8, mais si le décodage UTF-8 échoue, les valeurs sont décodées en caractères 8 bits.
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG
Valeur : 0x20000
T.61 est utilisé plutôt que l’encodage de caractères Unicode pour tous les caractères inférieurs à 0xFF. LDAP, par exemple, utilise T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG
Valeur : 0x40000
UTF-8 est utilisé pour le DN au lieu de l’encodage de caractères Unicode.
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
Valeur : 0x80000
Force les clés X.500 suivantes à être encodées sous forme de chaînes UTF-8 plutôt que de chaînes Unicode imprimables.


































































Clé :OID
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
TitreXCN_OID_TITLE
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG
Valeur : 0x100000
Empêche l’encodage forcé des chaînes Unicode imprimables à l’aide d’UTF-8. Utilisez quand vous le souhaitez lorsque XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG est le comportement par défaut.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG
Valeur : 0x200000
XCN_CERT_NAME_STR_DS_ESCAPED
Valeur : 0x800000

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête certenroll.h

Voir aussi

Énumérations CertEnroll

CertEnroll Interfaces

IX500DistinguishedName