Interface IAlternativeName (certenroll.h)
Uma coleção de interfaces IAlternativeName é usada por um objeto IX509ExtensionAlternativeNames para representar uma instância de uma extensão AlternativeNames . A coleção é representada pela interface IAlternativeNames . A sintaxe a seguir mostra a estrutura ASN.1 ( Abstract Syntax Notation One ) da extensão.
----------------------------------------------------------------------
-- 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
}
Você pode inicializar um objeto IAlternativeName de uma enumeração AlternativeNameType . Os tipos a seguir estão disponíveis, mas são compatíveis com métodos de inicialização diferentes, conforme indicado.
| Valor | Descrição | Método de inicialização |
|---|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | O nome consiste em um OID ( identificador de objeto ) e uma matriz de bytes. | InitializeFromOtherName |
| XCN_CERT_ALT_NAME_RFC822_NAME | O nome é um endereço de email. | InitializeFromString |
| XCN_CERT_ALT_NAME_DNS_NAME | O nome é um nome DNS (Sistema de Nomes de Domínio). | InitializeFromString |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | O nome é um nome de diretório X.500 . | InitializeFromRawData |
| XCN_CERT_ALT_NAME_URL | O nome é uma URL. | InitializeFromString |
| XCN_CERT_ALT_NAME_IP_ADDRESS | O nome é um endereço IP (Internet Protocol). | InitializeFromRawData |
| XCN_CERT_ALT_NAME_REGISTERED_ID | O nome é um OID registrado. | InitializeFromString |
| XCN_CERT_ALT_NAME_GUID | O nome é um GUID. | InitializeFromRawData |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | O nome é um UPN ( nome upn ). | InitializeFromString |
Herança
A interface IAlternativeName herda da interface IDispatch . IAlternativeName também tem estes tipos de membros:
Métodos
A interface IAlternativeName tem esses métodos.
| IAlternativeName::get_ObjectId Recupera o OID (identificador de objeto), se houver, associado ao nome. |
| IAlternativeName::get_RawData Recupera a matriz de bytes codificada em Distinguished Encoding Rules (DER) que contém o nome. |
| IAlternativeName::get_StrValue Recupera uma cadeia de caracteres que contém um endereço de email, um nome DNS (Sistema de Nomes de Domínio), uma URL, um OID (identificador de objeto registrado) ou um UPN (nome upn). |
| IAlternativeName::get_Type Recupera o tipo de nome alternativo. |
| IAlternativeName::InitializeFromOtherName Inicializa o objeto de um OID (identificador de objeto) e os dados brutos associados (matriz de bytes). |
| IAlternativeName::InitializeFromRawData Inicializa o objeto de um GUID DSA (Algoritmo de Assinatura Digital), um nome de diretório X.500 ou um endereço IP (Protocolo IP) contido em uma matriz de bytes codificada em Distinguished Encoding Rules (DER). |
| IAlternativeName::InitializeFromString Inicializa o objeto de uma cadeia de caracteres que contém um endereço de email, um nome DNS (Sistema de Nomes de Domínio), uma URL, um OID (identificador de objeto registrado) ou um UPN (nome upn). |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | certenroll.h |