structure CERT_RDN_ATTR (wincrypt.h)

Article
08/27/2023

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

Share via