Interfaz IAlternativeName (certenroll.h)

Artículo
03/08/2023

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

Consulte también

CertEnroll Interfaces

IAlternativeNames

IDispatch

IX509ExtensionAlternativeNames