IX500DistinguishedName-Schnittstelle (certenroll.h)

Die IX500DistinguishedName-Schnittstelle stellt einen X.500 Distinguished Name (DN) dar. Die Netzwerkstandards der X.500-Serie umfassen elektronische Verzeichnisdienste. Ein distinguished Name identifiziert (unterscheidet) jeden Eintrag im Verzeichnis eindeutig von allen anderen Einträgen. Jeder DN besteht aus einem oder mehreren relativen distinguished Names (RDNs).

Das Betrefffeld einer PKCS #10-Zertifikatanforderung enthält den DN der Entität, die das Zertifikat anfordert.

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

Der DN besteht aus einer Sequenz von RDNs. Jedes RDN besteht aus einem Satz von Attributen, und jedes Attribut besteht aus einem Objektbezeichner (Object Identifier, OID) und einem Wert. Der Datentyp des Werts wird durch die DirectoryString-Struktur identifiziert.

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)) 
}

Die folgenden RDN-Schlüssel und die zugehörigen OIDs werden derzeit unterstützt.

Schlüssel	OID	BESCHREIBUNG	RDN-Typ
C	XCN_OID_COUNTRY_NAME	Enthält einen iso 3166-Länder- oder Regionscode aus zwei Buchstaben.	PrintableString
CN	XCN_OID_COMMON_NAME	Enthält einen allgemeinen Namen.	PrintableString
EEMAIL	XCN_OID_RSA_emailAddr	Enthält eine E-Mail-Adresse.	IA5String
DC	XCN_OID_DOMAIN_COMPONENT	Enthält eine Komponente eines DNS-Namens (Domain Name System).	IA5String
GGivenName	XCN_OID_GIVEN_NAME	Enthält den Teil des Namens einer Person, der kein Nachname ist.	PrintableString
I	XCN_OID_INITIALS	Enthält die Initialen einer Person.	PrintableString
L	XCN_OID_LOCALITY_NAME	Enthält den Ortsnamen, der eine Stadt, ein Land oder eine andere geografische Region identifiziert.	PrintableString
O	XCN_OID_ORGANIZATION_NAME	Enthält den Namen eines organization.	PrintableString
OU	XCN_OID_ORGANIZATIONAL_UNIT_NAME	Enthält den Namen einer Einheitenunterteilung innerhalb einer organization.	PrintableString
SST	XCN_OID_STATE_OR_PROVINCE_NAME	Enthält den vollständigen Namen eines Bundesstaats oder einer Provinz.	PrintableString
STREET	XCN_OID_STREET_ADDRESS	Enthält die physische Adresse.	PrintableString
SN	XCN_OID_SUR_NAME	Enthält den Familiennamen einer Person.	PrintableString
TTITLE	XCN_OID_TITLE	Enthält den Titel einer Person im organization.	PrintableString

 

Jeder Dienst, der auf X.500 basiert, definiert eine eigene Distinguished Name String-Darstellung. LDAP verwendet beispielsweise eine durch Trennzeichen getrennte Liste, die von rechts nach links angeordnet ist. Active Directory verwendet einen Schrägstrich (/) und ordnet die Liste von links nach rechts an. Andere Dienste verwenden Semikolons als Trennzeichen. Das folgende Beispiel zeigt einen Active Directory-Eintrag für einen Mitarbeiter namens John Peoples, der in der Pharmazeutischen Abteilung eines Unternehmens mit dem Namen Contoso, Ltd. arbeitet.

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

Vererbung

Die IX500DistinguishedName-Schnittstelle erbt von der IDispatch-Schnittstelle . IX500DistinguishedName hat auch die folgenden Arten von Membern:

Methoden

Die IX500DistinguishedName-Schnittstelle verfügt über diese Methoden.

IX500DistinguishedName::D ecode Initialisiert das Objekt aus einem Unicode-codierten distinguished-Namen.
IX500DistinguishedName::Codieren Initialisiert das -Objekt aus einer Zeichenfolge, die einen distinguished Name enthält.
IX500DistinguishedName::get_EncodedName Ruft einen Unicode-codierten Distinguished-Namen ab.
IX500DistinguishedName::get_Name Ruft einen distinguished Name ab.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h

Weitere Informationen

CertEnroll-Schnittstellen

IDispatch

Antragstellernamen