IAlternativeName-Schnittstelle (certenroll.h)
Eine Auflistung von IAlternativeName-Schnittstellen wird von einem IX509ExtensionAlternativeNames-Objekt verwendet, um eine instance einer AlternativeNames-Erweiterung darzustellen. Die Auflistung wird durch die IAlternativeNames-Schnittstelle dargestellt. Die folgende Syntax zeigt die AsN.1-Struktur ( Abstract Syntax Notation One ) der Erweiterung.
----------------------------------------------------------------------
-- AlternativeNames
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------
AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames
GeneralName ::= CHOICE
{
otherName [0] IMPLICIT OtherName,
rfc822Name [1] IMPLICIT IA5STRING,
dNSName [2] IMPLICIT IA5STRING,
x400Address [3] IMPLICIT SeqOfAny, --Not supported
directoryName [4] EXPLICIT ANY,
ediPartyName [5] IMPLICIT SeqOfAny,
uniformResourceLocator [6] IMPLICIT IA5STRING,
iPAddress [7] IMPLICIT OCTETSTRING,
registeredID [8] IMPLICIT EncodedObjectID --Not supported
}
OtherName ::= SEQUENCE
{
type EncodedObjectID,
value [0] EXPLICIT NOCOPYANY
}
Sie können ein IAlternativeName-Objekt aus einer AlternativeNameType-Enumeration initialisieren. Die folgenden Typen sind verfügbar, werden jedoch wie angegeben von verschiedenen Initialisierungsmethoden unterstützt.
| Wert | BESCHREIBUNG | Initialisierungsmethode |
|---|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | Der Name besteht aus einem Objektbezeichner (OID) und einem Bytearray. | InitializeFromOtherName |
| XCN_CERT_ALT_NAME_RFC822_NAME | Der Name ist eine E-Mail-Adresse. | InitializeFromString |
| XCN_CERT_ALT_NAME_DNS_NAME | Der Name ist ein DNS-Name (Domain Name System). | InitializeFromString |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | Der Name ist ein X.500-Verzeichnisname . | InitializeFromRawData |
| XCN_CERT_ALT_NAME_URL | Der Name ist eine URL. | InitializeFromString |
| XCN_CERT_ALT_NAME_IP_ADDRESS | Der Name ist eine IP-Adresse (Internet Protocol). | InitializeFromRawData |
| XCN_CERT_ALT_NAME_REGISTERED_ID | Der Name ist eine registrierte OID. | InitializeFromString |
| XCN_CERT_ALT_NAME_GUID | Der Name ist eine GUID. | InitializeFromRawData |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | Der Name ist ein Benutzerprinzipalname (UPN). | InitializeFromString |
Vererbung
Die IAlternativeName-Schnittstelle erbt von der IDispatch-Schnittstelle . IAlternativeName verfügt auch über folgende Membertypen:
Methoden
Die IAlternativeName-Schnittstelle verfügt über diese Methoden.
| IAlternativeName::get_ObjectId Ruft den objektbezeichner (OID) ab, falls vorhanden, der dem Namen zugeordnet ist. |
| IAlternativeName::get_RawData Ruft das Distinguished Encoding Rules(DER)-codierte Bytearray ab, das den Namen enthält. |
| IAlternativeName::get_StrValue Ruft eine Zeichenfolge ab, die eine E-Mail-Adresse, einen DNS-Namen (Domain Name System), eine URL, einen registrierten Objektbezeichner (OID) oder einen Benutzerprinzipalnamen (UPN) enthält. |
| IAlternativeName::get_Type Ruft den alternativen Namenstyp ab. |
| IAlternativeName::InitializeFromOtherName Initialisiert das Objekt aus einem Objektbezeichner (OID) und den zugeordneten Rohdaten (Bytearray). |
| IAlternativeName::InitializeFromRawData Initialisiert das Objekt aus einer DSA-GUID (Digital Signature Algorithm), einem X.500-Verzeichnisnamen oder einer IP-Adresse (Internet Protocol), die in einem Distinguished Encoding Rules (DER)-codierten Bytearray enthalten ist. |
| IAlternativeName::InitializeFromString Initialisiert das Objekt aus einer Zeichenfolge, die eine E-Mail-Adresse, einen DNS-Namen (Domain Name System), eine URL, einen registrierten Objektbezeichner (OID) oder einen Benutzerprinzipalnamen (UPN) enthält. |
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 |