Interfaz IAlternativeName (certenroll.h)
Un objeto IX509ExtensionAlternativeNames usa una colección de interfaces IAlternativeNames para representar una instancia de una extensión AlternativeNames. La colección se representa mediante la interfaz IAlternativeNames . La sintaxis siguiente muestra la estructura Abstract Syntax Notation One (ASN.1) de la extensión.
----------------------------------------------------------------------
-- 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
}
Puede inicializar un objeto IAlternativeName desde una enumeración AlternativeNameType . Los siguientes tipos están disponibles, pero son compatibles con diferentes métodos de inicialización, como se indica.
| Valor | Descripción | Método de inicialización |
|---|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | El nombre consta de un identificador de objeto (OID) y una matriz de bytes. | InitializeFromOtherName |
| XCN_CERT_ALT_NAME_RFC822_NAME | El nombre es una dirección de correo electrónico. | InitializeFromString |
| XCN_CERT_ALT_NAME_DNS_NAME | El nombre es un nombre del Sistema de nombres de dominio (DNS). | InitializeFromString |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | El nombre es un nombre de directorio X.500 . | InitializeFromRawData |
| XCN_CERT_ALT_NAME_URL | El nombre es una dirección URL. | InitializeFromString |
| XCN_CERT_ALT_NAME_IP_ADDRESS | El nombre es una dirección de Protocolo de Internet (IP). | InitializeFromRawData |
| XCN_CERT_ALT_NAME_REGISTERED_ID | El nombre es un OID registrado. | InitializeFromString |
| XCN_CERT_ALT_NAME_GUID | El nombre es un GUID. | InitializeFromRawData |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | El nombre es un nombre principal de usuario (UPN). | InitializeFromString |
Herencia
La interfaz IAlternativeName hereda de la interfaz IDispatch . IAlternativeName también tiene estos tipos de miembros:
Métodos
La interfaz IAlternativeName tiene estos métodos.
| IAlternativeName::get_ObjectId Recupera el identificador de objeto (OID), si existe, asociado al nombre. |
| IAlternativeName::get_RawData Recupera la matriz de bytes codificada reglas de codificación distinguida (DER) que contiene el nombre. |
| IAlternativeName::get_StrValue Recupera una cadena que contiene una dirección de correo electrónico, un nombre del Sistema de nombres de dominio (DNS), una dirección URL, un identificador de objeto registrado (OID) o un nombre principal de usuario (UPN). |
| IAlternativeName::get_Type Recupera el tipo de nombre alternativo. |
| IAlternativeName::InitializeFromOtherName Inicializa el objeto a partir de un identificador de objeto (OID) y los datos sin procesar asociados (matriz de bytes). |
| IAlternativeName::InitializeFromRawData Inicializa el objeto a partir de un GUID de algoritmo de firma digital (DSA), un nombre de directorio X.500 o una dirección de protocolo de Internet (IP) contenida en una matriz de bytes codificada reglas de codificación distinguida (DER). |
| IAlternativeName::InitializeFromString Inicializa el objeto a partir de una cadena que contiene una dirección de correo electrónico, un nombre del Sistema de nombres de dominio (DNS), una dirección URL, un identificador de objeto registrado (OID) o un nombre principal de usuario (UPN). |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | certenroll.h |