Interfaccia IX500DistinguishedName (certenroll.h)

L'interfaccia IX500DistinguishedName rappresenta un nome distinto X.500 (DN). La serie X.500 di standard di rete copre i servizi di directory elettronici. Un nome distinto identifica (distingue) in modo univoco ogni voce nella directory da tutte le altre voci. Ogni DN è costituito da uno o più nomi distinti relativi (RDN).

Il campo oggetto di una richiesta di certificato PKCS #10 contiene il DN dell'entità che richiede il certificato

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

Il DN è costituito da una sequenza di rdn. Ogni rdn è costituito da un set di attributi e ogni attributo è costituito da un identificatore di oggetto (OID) e un valore. Il tipo di dati del valore è identificato dalla struttura 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)) 
}

Le chiavi RDN e gli ID associati sono attualmente supportati.

Chiave	OID	Descrizione	Tipo RDN
C	XCN_OID_COUNTRY_NAME	Contiene un codice ISO 3166 ISO 3166 paese o area geografica.	PrintableString
CN	XCN_OID_COMMON_NAME	Contiene un nome comune.	PrintableString
EEMAIL	XCN_OID_RSA_emailAddr	Contiene un indirizzo di posta elettronica.	IA5String
DC	XCN_OID_DOMAIN_COMPONENT	Contiene un componente di un nome DNS (Domain Name System).	IA5String
GGivenName	XCN_OID_GIVEN_NAME	Contiene la parte del nome di una persona che non è un cognome.	PrintableString
I	XCN_OID_INITIALS	Contiene le iniziali di una persona.	PrintableString
L	XCN_OID_LOCALITY_NAME	Contiene il nome della località che identifica una città, un paese o un'altra area geografica.	PrintableString
O	XCN_OID_ORGANIZATION_NAME	Contiene il nome di un'organizzazione.	PrintableString
OU	XCN_OID_ORGANIZATIONAL_UNIT_NAME	Contiene il nome di una suddivisione di unità all'interno di un'organizzazione.	PrintableString
SST	XCN_OID_STATE_OR_PROVINCE_NAME	Contiene il nome completo di uno stato o di una provincia.	PrintableString
STREET	XCN_OID_STREET_ADDRESS	Contiene l'indirizzo fisico.	PrintableString
SN	XCN_OID_SUR_NAME	Contiene il nome della famiglia di una persona.	PrintableString
TTITLE	XCN_OID_TITLE	Contiene il titolo di una persona nell'organizzazione.	PrintableString

 

Ogni servizio basato su X.500 definisce la relativa rappresentazione di stringa di nome distinto. Ad esempio, LDAP usa un elenco delimitato da virgole disposto da destra a sinistra. Active Directory usa una barra (/) e dispone l'elenco da sinistra a destra. Altri servizi usano punti e virgola come separatori. L'esempio seguente mostra una voce di Active Directory per un dipendente denominato John People che lavora nella divisione farmaceutica di una società denominata Contoso, Ltd.

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

Ereditarietà

L'interfaccia IX500DistinguishedName eredita dall'interfaccia IDispatch . IX500DistinguishedName include anche questi tipi di membri:

Metodi

L'interfaccia IX500DistinguishedName include questi metodi.

IX500DistinguishedName::D ecode Inizializza l'oggetto da un nome distinto con codifica Unicode.
IX500DistinguishedName::Encode Inizializza l'oggetto da una stringa contenente un nome distinto.
IX500DistinguishedName::get_EncodedName Recupera un nome distinto con codifica Unicode.
IX500DistinguishedName::get_Name Recupera un nome distinto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h

Vedi anche

Interfacce CertEnroll

Idispatch

Nomi soggetto