Função NetAddAlternateComputerName (lmjoin.h)

Artigo
08/24/2023

A função NetAddAlternateComputerName adiciona um nome alternativo para o computador especificado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetAddAlternateComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR AlternateName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

Parâmetros

[in, optional] Server

Um ponteiro para uma cadeia de caracteres constante que especifica o nome do computador no qual executar essa função. Se esse parâmetro for NULL, o computador local será usado.

[in] AlternateName

Um ponteiro para uma cadeia de caracteres constante que especifica o nome alternativo a ser adicionado. Esse nome deve estar na forma de um nome DNS totalmente qualificado.

[in, optional] DomainAccount

Um ponteiro para uma cadeia de caracteres constante que especifica a conta de domínio a ser usada para acessar o objeto de conta de computador do computador especificado no parâmetro Server no Active Directory. Se esse parâmetro for NULL, as credenciais do usuário que executa essa rotina serão usadas.

Esse parâmetro não será usado se o servidor para executar essa função não estiver ingressado em um domínio.

[in, optional] DomainAccountPassword

Um ponteiro para uma cadeia de caracteres constante que especifica a senha que corresponde à conta de domínio passada no parâmetro DomainAccount . Se esse parâmetro for NULL, as credenciais do usuário que executa essa rotina serão usadas.

Esse parâmetro será ignorado se o parâmetro DomainAccount for NULL. Esse parâmetro não será usado se o servidor para executar essa função não estiver ingressado em um domínio.

[in] Reserved

Reservado para uso futuro. Esse parâmetro deve ser NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro ou um dos códigos de erro do sistema.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	O acesso foi negado. Esse erro será retornado se o chamador não for membro do grupo local Administradores no computador de destino.
ERROR_INVALID_NAME	Um parâmetro de nome está incorreto. Esse erro será retornado se o parâmetro AlternateName não contiver um nome válido.
ERROR_INVALID_PARAMETER	Um parâmetro está incorreto. Esse erro será retornado se o parâmetro DomainAccount não contiver um domínio válido. Esse erro também será retornado se o parâmetro DomainAccount não for NULL e o parâmetro DomainAccountPassword não for NULL , mas não contiver uma cadeia de caracteres Unicode.
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente disponível para processar esse comando.
ERROR_NOT_SUPPORTED	A solicitação não terá suporte. Esse erro será retornado se o computador de destino especificado no parâmetro Server no qual essa função é executada estiver em execução no Windows 2000 e anterior.
NERR_WkstaNotStarted	O serviço estação de trabalho não foi iniciado.
RPC_S_CALL_IN_PROGRESS	Uma chamada de procedimento remoto já está em andamento para esse thread.
RPC_S_PROTSEQ_NOT_SUPPORTED	Não há suporte para a sequência de protocolo de chamada de procedimento remoto.

Comentários

A função NetAddAlternateComputerName tem suporte no Windows XP e posterior.

A função NetAddAlternateComputerName é usada para definir nomes de rede secundários para computadores. O nome principal é o nome usado para autenticação e mapeia para o nome da conta do computador.

A função NetAddAlternateComputerName requer que o chamador seja membro do grupo local Administradores no computador de destino.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	lmjoin.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll