Função AddLocalAlternateComputerName

Artigo
06/13/2023

Adiciona um nome de rede local alternativo para o computador do qual ele é chamado.

Sintaxe

DWORD AddLocalAlternateComputerName(
  _In_ LPCTSTR lpDnsFQHostname,
  _In_ ULONG   ulFlags
);

Parâmetros

lpDnsFQHostname [in]: O nome alternativo a ser adicionado. O nome deve estar no formato ComputerNameDnsFullyQualified , conforme definido na enumeração COMPUTER_NAME_FORMAT , e a função DnsValidateName_W deve ser capaz de validá-lo com seu formato definido como DnsNameHostnameFull.
ulFlags [in]: Esse parâmetro é reservado e deve ser definido como zero.

Valor retornado

Se a função for bem-sucedida, a função retornará ERROR_SUCCESS. Se a função falhar, ela retornará um código de erro diferente de zero. Entre os códigos de erro retornados estão os seguintes:

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	Indica que o parâmetro lpDnsFQHostname não aponta para um nome DNS válido ou que o parâmetro ulFlags não é igual a zero.
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente para concluir a operação.

Requisitos

Requisito	Valor
Biblioteca	Kernel32.lib
DLL	Kernel32.dll
Nomes Unicode e ANSI	AddLocalAlternateComputerNameW (Unicode) e AddLocalAlternateComputerNameA (ANSI)

Confira também

COMPUTER_NAME_FORMAT
DnsValidateName_W

Compartilhar via