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 |