Partager via


Interface IX500DistinguishedName (certenroll.h)

L’interface IX500DistinguishedName représente un nom unique (DN) X.500. La série X.500 de normes de mise en réseau couvre les services d’annuaire électronique. Un nom unique identifie (distingue) de manière unique chaque entrée du répertoire de toutes les autres entrées. Chaque DN se compose d’un ou plusieurs noms uniques relatifs (RDN).

Le champ objet d’une demande de certificat PKCS #10 contient le nom de domaine de l’entité qui demande le certificat


CertificationRequestInfo ::= SEQUENCE 
{
   version                 CertificationRequestInfoVersion,
   subject                 Name,
   subjectPublicKeyInfo    SubjectPublicKeyInfo,
   attributes              [0] IMPLICIT Attributes
}

Le nom de domaine se compose d’une séquence de RDN. Chaque RDN se compose d’un ensemble d’attributs, et chaque attribut se compose d’un identificateur d’objet (OID) et d’une valeur. Le type de données de la valeur est identifié par la structure DirectoryString .


Name ::= SEQUENCE OF RelativeDistinguishedName

RelativeDistinguishedName ::= SET OF AttributeTypeValue

AttributeTypeValue ::= SEQUENCE 
{
   type       EncodedObjectID,
   value      ANY 
}

DirectoryString ::= CHOICE 
{
   teletexString           TeletexString (SIZE (1..MAX)),
   printableString         PrintableString (SIZE (1..MAX)),
   universalString         UniversalString (SIZE (1..MAX)),
   utf8String              UTF8String (SIZE (1..MAX)),
   bmpString               BMPString (SIZE (1..MAX)) 
}

Les clés RDN suivantes et les OID associés sont actuellement pris en charge.

Clé : OID Description Type RDN
C XCN_OID_COUNTRY_NAME Contient un code de pays ou de région ISO 3166 à deux lettres. PrintableString
CN XCN_OID_COMMON_NAME Contient un nom commun. PrintableString
EEMAIL XCN_OID_RSA_emailAddr Contient une adresse e-mail. IA5String
DC XCN_OID_DOMAIN_COMPONENT Contient un composant d’un nom DNS (Domain Name System). IA5String
GGivenName XCN_OID_GIVEN_NAME Contient la partie du nom d’une personne qui n’est pas un nom de famille. PrintableString
I XCN_OID_INITIALS Contient les initiales d’une personne. PrintableString
L XCN_OID_LOCALITY_NAME Contient le nom de la localité qui identifie une ville, un pays ou une autre région géographique. PrintableString
O XCN_OID_ORGANIZATION_NAME Contient le nom d’un organization. PrintableString
OU XCN_OID_ORGANIZATIONAL_UNIT_NAME Contient le nom d’une subdivision d’unité au sein d’une organization. PrintableString
SST XCN_OID_STATE_OR_PROVINCE_NAME Contient le nom complet d’un état ou d’une province. PrintableString
STREET XCN_OID_STREET_ADDRESS Contient l’adresse physique. PrintableString
SN XCN_OID_SUR_NAME Contient le nom de famille d’une personne. PrintableString
TTITLE XCN_OID_TITLE Contient le titre d’une personne dans le organization. PrintableString
 

Chaque service basé sur X.500 définit sa propre représentation de chaîne de nom unique. Par exemple, LDAP utilise une liste délimitée par des virgules organisée de droite à gauche. Active Directory utilise une barre oblique (/) et organise la liste de gauche à droite. D’autres services utilisent des points-virgules comme séparateurs. L’exemple suivant montre une entrée Active Directory pour un employé nommé John Peoples qui travaille dans la division pharmaceutique d’une société nommée Contoso, Ltd.


/c=gb/o=Contoso Ltd./ou=Contoso Pharmaceuticals/cn=John Peoples

Héritage

L’interface IX500DistinguishedName hérite de l’interface IDispatch. IX500DistinguishedName a également les types de membres suivants :

Méthodes

L’interface IX500DistinguishedName contient ces méthodes.

 
IX500DistinguishedName ::D ecode

Initialise l’objet à partir d’un nom unique encodé en Unicode.
IX500DistinguishedName ::Encode

Initialise l’objet à partir d’une chaîne qui contient un nom unique.
IX500DistinguishedName ::get_EncodedName

Récupère un nom unique encodé en Unicode.
IX500DistinguishedName ::get_Name

Récupère un nom unique.

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]
Plateforme cible Windows
En-tête certenroll.h

Voir aussi

CertEnroll Interfaces

IDispatch

Noms de sujets