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 |