Função NetRemoveAlternateComputerName (lmjoin.h)

Artigo
08/24/2023

A função NetRemoveAlternateComputerName remove um nome alternativo para o computador especificado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetRemoveAlternateComputerName(
  [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 removido. 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 do computador para o computador especificado no parâmetro Server no Active Directory. Se esse parâmetro for NULL, as credenciais do usuário que está executando essa rotina serão usadas.

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

[in, optional] DomainAccountPassword

Um ponteiro para uma cadeia de caracteres constante que especifica a senha correspondente à conta de domínio passada no parâmetro DomainAccount . Se esse parâmetro for NULL, as credenciais do usuário que está executando 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 associado a 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 códigos de erro a seguir 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 NetRemoveAlternateComputerName tem suporte no Windows XP e posterior.

A função NetRemoveAlternateComputerName é usada para remover nomes de computador secundários configurados para o computador de destino.

A função NetRemoveAlternateComputerName 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