Método ICertEncodeAltName::GetNameChoice (certenc.h)

Artigo
08/22/2023

O método GetNameChoice retorna a opção de nome em um índice especificado de uma matriz de nomes alternativa.

Sintaxe

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

Parâmetros

[in] NameIndex

Especifica o índice da entrada de nome alternativo. A primeira entrada está no índice zero.

[out] pNameChoice

Um ponteiro para um LONG que recebe o especificador de opção de nome.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e o parâmetro pNameChoice apontará para um valor que indica o tipo do nome alternativo. Esse é um dos valores a seguir.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é a opção de nome no índice especificado. A escolha do nome indica o tipo do nome alternativo para que ele possa ser usado corretamente. Deve ser um dos valores a seguir.

Código de retorno	Descrição
CERT_ALT_NAME_DIRECTORY_NAME	O nome é um nome de diretório.
CERT_ALT_NAME_DNS_NAME	O nome é uma cadeia de caracteres IA5 que contém um nome DNS (Sistema de Nomes de Domínio) no formato Host.Entidade.Domínio.
CERT_ALT_NAME_IP_ADDRESS	O nome é uma cadeia de caracteres de octeto que representa um endereço de protocolo da Internet.
CERT_ALT_NAME_REGISTERED_ID	O nome é um OID ( identificador de objeto registrado).
CERT_ALT_NAME_RFC822_NAME	O nome é um endereço de email.
CERT_ALT_NAME_URL	O nome é uma cadeia de caracteres IA5 que contém uma URL no formato Service://HostName/Path.
CERT_ALT_NAME_OTHER_NAME	O nome consiste em um OID e um BLOB binário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenc.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certenc.dll

Confira também

ICertEncodeAltName

ICertEncodeAltName::GetName

ICertEncodeAltName::SetNameEntry

Compartilhar via