Partager via


structure CERT_RDN_ATTR (wincrypt.h)

La structure CERT_RDN_ATTR contient un attribut unique d’un nom unique relatif (RDN). Un RDN entier est exprimé dans une structure CERT_RDN qui contient un tableau de structures CERT_RDN_ATTR .

Syntaxe

typedef struct _CERT_RDN_ATTR {
  LPSTR               pszObjId;
  DWORD               dwValueType;
  CERT_RDN_VALUE_BLOB Value;
} CERT_RDN_ATTR, *PCERT_RDN_ATTR;

Membres

pszObjId

Identificateur d’objet (OID) pour le type de l’attribut défini dans cette structure. Ce membre peut être l’un des OID suivants.

Valeur Signification
szOID_AUTHORITY_REVOCATION_LIST
Attribut de sécurité.
szOID_BUSINESS_CATEGORY
Chaîne ne respectant pas la casse. Attribut explicatif.
szOID_CA_CERTIFICATE
Attribut de sécurité.
szOID_CERTIFICATE_REVOCATION_LIST
Attribut de sécurité.
szOID_COMMON_NAME
Chaîne ne respectant pas la casse. Attribut d’étiquetage.
szOID_COUNTRY_NAME
Chaîne imprimable à deux caractères. Attribut géographique.
szOID_CROSS_CERTIFICATE_PAIR
Attribut de sécurité.
szOID_DESCRIPTION
Chaîne ne respectant pas la casse. Attribut explicatif.
szOID_DESTINATION_INDICATOR
Chaîne imprimable. Attribut d’adressage de télécommunications.
szOID_DEVICE_SERIAL_NUMBER
Chaîne imprimable. Attribut d’étiquetage.
szOID_DOMAIN_COMPONENT
Chaîne IA5. Composant de nom DNS tel que « com ».
szOID_FACSIMILE_TELEPHONE_NUMBER
Attribut d’adressage de télécommunications.
szOID_GIVEN_NAME
Chaîne ne respectant pas la casse. Attribut Name.
szOID_INITIALS
Chaîne ne respectant pas la casse. Attribut Name.
szOID_INTERNATIONAL_ISDN_NUMBER
Chaîne numérique. Attribut d’adressage de télécommunications.
szOID_LOCALITY_NAME
Chaîne ne respectant pas la casse. Attribut géographique.
szOID_MEMBER
Attribut d’application relationnelle.
szOID_ORGANIZATION_NAME
Chaîne ne respectant pas la casse. Attribut organisationnel.
szOID_ORGANIZATIONAL_UNIT_NAME
Chaîne ne respectant pas la casse. Attribut organisationnel.
szOID_OWNER
Attribut d’application relationnelle.
szOID_PHYSICAL_DELIVERY_OFFICE_NAME
Chaîne ne respectant pas la casse. Attribut d’adressage postal.
szOID_PKCS_12_FRIENDLY_NAME_ATTR
Attribut PKCS #12.
szOID_PKCS_12_LOCAL_KEY_ID
Attribut PKCS #12.
szOID_POST_OFFICE_BOX
Chaîne ne respectant pas la casse. Attribut d’adressage postal.
szOID_POSTAL_ADDRESS
Chaîne imprimable. Attribut d’adressage postal.
szOID_POSTAL_CODE
Chaîne ne respectant pas la casse. Attribut d’adressage postal.
szOID_PREFERRED_DELIVERY_METHOD
Attribut de préférence.
szOID_PRESENTATION_ADDRESS
Attribut d’application OSI.
szOID_REGISTERED_ADDRESS
Attribut d’adressage de télécommunications.
szOID_ROLE_OCCUPANT
Attribut d’application relationnelle.
szOID_RSA_emailAddr
Chaîne IA5. Email attribut.
szOID_SEARCH_GUIDE
Attribut explicatif.
szOID_SEE_ALSO
Attribut d’application relationnelle.
szOID_STATE_OR_PROVINCE_NAME
Chaîne ne respectant pas la casse. Attribut géographique.
szOID_STREET_ADDRESS
Chaîne ne respectant pas la casse. Attribut géographique.
szOID_SUPPORTED_APPLICATION_CONTEXT
Attribut d’application OSI.
szOID_SUR_NAME
Chaîne ne respectant pas la casse. Attribut d’étiquetage.
szOID_TELEPHONE_NUMBER
Attribut d’adressage de télécommunications.
szOID_TELETEXT_TERMINAL_IDENTIFIER
Attribut d’adressage de télécommunications.
szOID_TELEX_NUMBER
Attribut d’adressage de télécommunications.
szOID_TITLE
Chaîne ne respectant pas la casse. Attribut organisationnel.
szOID_USER_CERTIFICATE
Attribut de sécurité.
szOID_USER_PASSWORD
Attribut de sécurité.
szOID_X21_ADDRESS
Chaîne numérique. Attribut d’adressage de télécommunications.

dwValueType

Indique l’interprétation du membre Value .

Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
CERT_RDN_ANY_TYPE
Le membre pszObjId détermine le type et la longueur supposés.
CERT_RDN_BMP_STRING
Tableau de caractères Unicode (16 bits).
CERT_RDN_ENCODED_BLOB
Objet BLOB de données encodé.
CERT_RDN_GENERAL_STRING
Pas utilisé pour l’instant.
CERT_RDN_GRAPHIC_STRING
Pas utilisé pour l’instant.
CERT_RDN_IA5_STRING
Chaîne arbitraire de caractères IA5 (ASCII).
CERT_RDN_INT4_STRING
Tableau d’éléments INT4 (32 bits).
CERT_RDN_ISO646_STRING
Jeu de 128 caractères (8 bits).
CERT_RDN_NUMERIC_STRING
Seuls les caractères 0 à 9 et l’espace (8 bits).
CERT_RDN_OCTET_STRING
Chaîne arbitraire d’octets (8 bits).
CERT_RDN_PRINTABLE_STRING
Chaîne arbitraire de caractères imprimables (8 bits).
CERT_RDN_T61_STRING
Chaîne arbitraire de caractères T.61 (8 bits).
CERT_RDN_TELETEX_STRING
Chaîne arbitraire de caractères T.61 (8 bits)
CERT_RDN_UNICODE_STRING
Tableau de caractères Unicode (16 bits).
CERT_RDN_UNIVERSAL_STRING
Tableau d’éléments INT4 (32 bits).
CERT_RDN_UTF8_STRING
Tableau de caractères Unicode 16 bits encodés sur le câble sous la forme d’une séquence de un, deux ou trois caractères huit bits.
CERT_RDN_VIDEOTEX_STRING
Chaîne arbitraire de caractères vidéo.
CERT_RDN_VISIBLE_STRING
Jeu de 95 caractères (8 bits).
 

Les indicateurs suivants peuvent être combinés à l’aide d’une opération OR au niveau du bit dans le membre dwValueType .

Valeur Signification
CERT_RDN_DISABLE_CHECK_TYPE_FLAG
Pour l’encodage. Lorsqu’ils sont définis, les caractères ne sont pas vérifiés pour déterminer s’ils sont valides pour le type valeur.
CERT_RDN_DISABLE_IE4_UTF8_FLAG
Pour le décodage. Par défaut, CERT_RDN_T61_STRING valeurs encodées sont initialement décodées en UTF8. Si le décodage UTF8 échoue, la valeur est décodée en caractères 8 bits. Si cet indicateur est défini, il ignore la tentative initiale de décodage en UTF8 et décode la valeur en caractères 8 bits.
CERT_RDN_ENABLE_T61_UNICODE_FLAG
Pour l’encodage. Lorsque la valeur est définie, si tous les caractères Unicode sont <= 0xFF, la valeur CERT_RDN_T61_STRING est sélectionnée au lieu de la valeur CERT_RDN_UNICODE_STRING .
CERT_RDN_ENABLE_UTF8_UNICODE_FLAG
Pour l’encodage. Lorsqu’elles sont définies, les chaînes sont encodées avec la valeur CERT_RDN_UTF8_STRING au lieu de la valeur CERT_RDN_UNICODE_STRING .
CERT_RDN_FORCE_UTF8_UNICODE_FLAG
Pour l’encodage. Lorsqu’elles sont définies, les chaînes sont encodées avec la valeur CERT_RDN_UTF8_STRING au lieu de CERT_RDN_PRINTABLE_STRING valeur pour les types DirectoryString. En outre, CERT_RDN_ENABLE_UTF8_UNICODE_FLAG est activé.

Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.

CERT_RDN_ENABLE_PUNYCODE_FLAG
Pour l’encodage. Si la chaîne contient un rdn d’e-mail et que l’adresse e-mail est encodée en Punycode, l’adresse e-mail résultante est encodée en tant que IA5String. L’encodage Punycode du nom d’hôte est effectué sur une base étiquette par étiquette.

Pour le décodage. Si le nom contient un rdn d’e-mail et que la partie locale ou la partie du nom d’hôte de l’adresse e-mail contient un code IA5String encodé en Punycode, la valeur de la chaîne RDN est convertie en son équivalent Unicode.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.

Value

CERT_RDN_VALUE_BLOB qui contient la valeur de l’attribut. Le membre cbData de Value est la longueur, en octets, du membre pbData . Il ne s’agit pas du nombre d’éléments dans la chaîne pbData .

Par exemple, un DWORD a une longueur de 32 bits ou de 4 octets. Si pbData est un tableau DWORD , cbData est quatre fois plus grand que le nombre d’éléments DWORD dans le tableau. Un short a une longueur de 16 bits ou de 2 octets. Si pbData est un tableau d’éléments SHORT , cbData doit avoir deux fois la longueur du tableau.

Le membre pbData de Value peut être un tableau avec fin null de caractères 8 bits ou 16 bits ou un tableau d’éléments de longueur fixe. Si dwValueType a la valeur CERT_RDN_ENCODED_BLOB, pbData est encodé.

Configuration requise

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

Voir aussi

CERT_RDN

CRYPT_INTEGER_BLOB

CertIsRDNAttrsInCertificateName