IAlternativeName-Schnittstelle (certenroll.h)

Artikel
08/22/2023

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

Weitere Informationen

CertEnroll-Schnittstellen

IAlternativeNames

IDispatch

IX509ExtensionAlternativeNames