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

Artigo
02/26/2024

O método SetNameEntry define um nome em um índice especificado da matriz de nomes alternativa.

Antes de usar esse método, você deve chamar ICertEncodeAltName::Reset para que o objeto saiba quantos elementos estão na matriz.

Sintaxe

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

Parâmetros

[in] NameIndex

Índice baseado em zero que especifica o índice da entrada de nome alternativo a ser definida.

Se o parâmetro NameChoice for CERT_ALT_NAME_OTHER_NAME, OR (|) o valor do índice com EAN_NAMEOBJECTID (definido como 0x80000000) para definir o OID. Caso contrário, o valor binário será definido.

[in] NameChoice

Especifica a escolha do nome. A escolha do nome indica o tipo do nome alternativo para que ele possa ser usado corretamente. Deve ser um dos valores a seguir.

Valor	Significado
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 especifica um nome DNS (Sistema de Nomes de Domínio) no formato host.entity.domain.
CERT_ALT_NAME_IP_ADDRESS	O nome é uma cadeia de caracteres de octeto que representa um endereço de Protocolo de 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 Caminho service://HostName/.
CERT_ALT_NAME_OTHER_NAME	O nome consiste em um OID ( identificador de objeto ) e um BLOB binário.

[in] strName

Especifica o nome alternativo.

Retornar valor

VB

Se o método for bem-sucedido, o método retornará S_OK.

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.

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

Compartilhar via