Interface IAlternativeName (certenroll.h)

Artigo
08/22/2023

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