Interfaccia IAlternativeName (certenroll.h)

Articolo
08/22/2023

Una raccolta di interfacce IAlternativeName viene usata da un oggetto IX509ExtensionAlternativeNames per rappresentare un'istanza di un'estensione AlternativeNames . La raccolta è rappresentata dall'interfaccia IAlternativeNames . La sintassi seguente mostra la struttura Asn.1 (AsN.1) della sintassi astratta dell'estensione.


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

È possibile inizializzare un oggetto IAlternativeName da un'enumerazione AlternativeNameType . I tipi seguenti sono disponibili, ma sono supportati da diversi metodi di inizializzazione, come indicato.

Valore	Descrizione	Metodo di inizializzazione
XCN_CERT_ALT_NAME_OTHER_NAME	Il nome è costituito da un identificatore di oggetto (OID) e una matrice di byte.	InitializeFromOtherName
XCN_CERT_ALT_NAME_RFC822_NAME	Il nome è un indirizzo di posta elettronica.	InitializeFromString
XCN_CERT_ALT_NAME_DNS_NAME	Il nome è un nome DNS (Domain Name System).	InitializeFromString
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Il nome è un nome di directory X.500 .	InitializeFromRawData
XCN_CERT_ALT_NAME_URL	Il nome è un URL.	InitializeFromString
XCN_CERT_ALT_NAME_IP_ADDRESS	Il nome è un indirizzo IP (Internet Protocol).	InitializeFromRawData
XCN_CERT_ALT_NAME_REGISTERED_ID	Il nome è un OID registrato.	InitializeFromString
XCN_CERT_ALT_NAME_GUID	Il nome è un GUID.	InitializeFromRawData
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Il nome è un nome dell'entità utente (UPN).	InitializeFromString

Ereditarietà

L'interfaccia IAlternativeName eredita dall'interfaccia IDispatch . IAlternativeName include anche questi tipi di membri:

Metodi

L'interfaccia IAlternativeName include questi metodi.


IAlternativeName::get_ObjectId Recupera l'identificatore dell'oggetto (OID), se presente, associato al nome.
IAlternativeName::get_RawData Recupera la matrice di byte codificata Distinguished Encoding Rules (DER) che contiene il nome.
IAlternativeName::get_StrValue Recupera una stringa contenente un indirizzo di posta elettronica, un nome DNS (Domain Name System), un URL, un identificatore di oggetto registrato (OID) o un nome dell'entità utente (UPN).
IAlternativeName::get_Type Recupera il tipo di nome alternativo.
IAlternativeName::InitializeFromOtherName Inizializza l'oggetto da un identificatore di oggetto (OID) e i dati non elaborati associati (matrice di byte).
IAlternativeName::InitializeFromRawData Inizializza l'oggetto da un GUID (Digital Signature Algorithm), un nome di directory X.500 o un indirizzo IP (Internet Protocol) contenuto in una matrice di byte con codifica Distinguished Encoding Rules (DER).
IAlternativeName::InitializeFromString Inizializza l'oggetto da una stringa contenente un indirizzo di posta elettronica, un nome DNS (Domain Name System), un URL, un identificatore di oggetto registrato (OID) o un nome dell'entità utente (UPN).

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

Vedi anche

Interfacce CertEnroll

IAlternativeNames

Idispatch

IX509ExtensionAlternativeNames