Interfaccia IAlternativeName (certenroll.h)
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 |