Énumération X500NameFlags (certenroll.h)
Le type d’énumération X500NameFlags spécifie les caractéristiques d’encodage d’affichage et de d’un nom unique ou nom unique relatif (RDN). Cette énumération est utilisée pour initialiser un objet IX500DistinguishedName.
Syntaxe
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_NONEValeur : 0 Les caractéristiques d’affichage ne sont pas identifiées. |
XCN_CERT_SIMPLE_NAME_STRValeur : 1 Tous les identificateurs d’objet (OID) sont ignorés. 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é entre espaces (+ ). |
XCN_CERT_OID_NAME_STRValeur : 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_STRValeur : 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 un espace blanc de début ou de fin ou l’un des caractères suivants :
|
XCN_CERT_XML_NAME_STRValeur : 4 Les OID sont traités de la même manière que ceux utilisés pour convertir des valeurs XCN_CERT_X500_NAME_ST, sauf qu’elles sont mises en forme comme une séquence d’éléments XML. Ceci est illustré dans l’exemple suivant : Les caractères de balisage XML Unicode sont échappés de la manière suivante. Les caractères supérieurs à 0x7F sont échappés à l’aide de références de caractères (L »&#xXXXX ; »).
|
XCN_CERT_NAME_STR_SEMICOLON_FLAGValeur : 0x40000000 Le séparateur de virgules (,) utilisé entre les RDN est remplacé par un point-virgule (;) caractère). |
XCN_CERT_NAME_STR_NO_PLUS_FLAGValeur : 0x20000000 Le séparateur (+) utilisé entre les attributs RDN est remplacé par un seul espace. |
XCN_CERT_NAME_STR_NO_QUOTING_FLAGValeur : 0x10000000 Empêche l’utilisation de guillemets pour la valeur XCN_CERT_X500_NAME_ST. |
XCN_CERT_NAME_STR_CRLF_FLAGValeur : 0x8000000 Le séparateur de virgules (,) utilisé entre les RDN est remplacé par une séquence de retour chariot/saut de ligne (\r\n). |
XCN_CERT_NAME_STR_COMMA_FLAGValeur : 0x4000000 Spécifie que le séparateur entre les RDN est une virgule (,). |
XCN_CERT_NAME_STR_REVERSE_FLAGValeur : 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 remplacer l’ordre d’encodage par DC=com,...,CN=nom. 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_FLAGValeur : 0x1000000 Permet d’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_FLAGValeur : 0x10000 Ignore la tentative initiale de décoder les 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 sous forme de caractères 8 bits. |
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAGValeur : 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_FLAGValeur : 0x40000 UTF-8 est utilisé pour le nom unique (DN) au lieu de l’encodage de caractères Unicode. |
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAGValeur : 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. Voici la liste des clés et de leurs identificateurs d’objet (OID).
|
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAGValeur : 0x100000 Empêche l’encodage des chaînes Unicode imprimables à l’aide de UTF-8. Utilisez quand vous le souhaitez quand XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG est le comportement par défaut. |
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAGValeur : 0x200000 Les chaînes contenant des caractères Unicode sont transcodées en Punycode, un sous-ensemble de caractères ASCII limité utilisé pour les noms d’hôte Internet. Ce sous-ensemble de caractères ASCII se compose de lettres, de chiffres et de traits d’union. |
XCN_CERT_NAME_STR_DS_ESCAPEDValeur : 0x800000 Les caractères d’échappement qui ne sont pas autorisés dans les noms uniques (DN). |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| d’en-tête | certenroll.h |