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

  • Artigo

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