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 |