Compartir a través de


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

Consulte también

CertEnroll Interfaces

IAlternativeNames

IDispatch

IX509ExtensionAlternativeNames