Interfaz IX509ExtensionAlternativeNames (certenroll.h)

La interfaz IX509ExtensionAlternativeNames permite especificar uno o varios formularios de nombre alternativos para el sujeto de un certificado. Una entidad de certificación procesa la extensión enlazando los nombres a la clave pública certificada. La sintaxis siguiente muestra la estructura Abstract Syntax Notation One (ASN.1) de la extensión. El valor de extensión se codifica mediante reglas de codificación distinguida (DER) y se incluye en la solicitud de certificado.


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

Si inicializa esta extensión mediante una colección IAlternativeNames , se admiten los siguientes tipos de nombre.

Valor Descripción
XCN_CERT_ALT_NAME_OTHER_NAME El nombre consta de un identificador de objeto y una matriz de bytes que contiene el nombre.
XCN_CERT_ALT_NAME_RFC822_NAME El nombre es una dirección de correo electrónico.
XCN_CERT_ALT_NAME_DNS_NAME El nombre es un nombre del sistema de nombres de dominio.
XCN_CERT_ALT_NAME_DIRECTORY_NAME El nombre es un nombre de directorio X.500 .
XCN_CERT_ALT_NAME_URL El nombre es una dirección URL.
XCN_CERT_ALT_NAME_IP_ADDRESS El nombre es una dirección de Protocolo de Internet (IP).
XCN_CERT_ALT_NAME_REGISTERED_ID El nombre es un identificador de objeto registrado (OID).
XCN_CERT_ALT_NAME_GUID El nombre es un GUID. Se trata de una forma de otherName.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME El nombre es un nombre principal de usuario (UPN). El formato UPN se basa en RFC 822.
 

Para agregar este objeto de extensión a una solicitud PKCS #10 o una solicitud CMC, primero debe agregarlo a una colección IX509Extensions y usar la colección para inicializar un objeto IX509AttributeExtensions . Para obtener más información, vea los temas PKCS #10 Extensions (Extensiones de PKCS #10 ) y CMC Extensions (Extensiones de CMC ).

Herencia

La interfaz IX509ExtensionAlternativeNames hereda de IX509Extension. IX509ExtensionAlternativeNames también tiene estos tipos de miembros:

Métodos

La interfaz IX509ExtensionAlternativeNames tiene estos métodos.

 
IX509ExtensionAlternativeNames::get_AlternativeNames

Recupera una colección de nombres alternativos de sujeto.
IX509ExtensionAlternativeNames::InitializeDecode

Inicializa la extensión a partir de una matriz de bytes codificada reglas de codificación distinguida (DER) que contiene el valor de extensión. (IX509ExtensionAlternativeNames.InitializeDecode)
IX509ExtensionAlternativeNames::InitializeEncode

Inicializa la extensión de una colección IAlternativeNames.

Requisitos

   
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

API de inscripción de certificado

Extensiones

IX509Extension