Função NetAddAlternateComputerName (lmjoin.h)
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 |
|---|---|
|
O acesso foi negado. Esse erro será retornado se o chamador não for membro do grupo local Administradores no computador de destino. |
|
Um parâmetro de nome está incorreto. Esse erro será retornado se o parâmetro AlternateName não contiver um nome válido. |
|
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. |
|
Não há memória suficiente disponível para processar esse comando. |
|
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. |
|
O serviço estação de trabalho não foi iniciado. |
|
Uma chamada de procedimento remoto já está em andamento para esse thread. |
|
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 |