Compartilhar via


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

Confira também

CertEnroll Interfaces

IAlternativeNames

IDispatch

IX509ExtensionAlternativeNames