Função NetRemoveAlternateComputerName (lmjoin.h)

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

Confira também

NetAddAlternateComputerName

NetEnumerateComputerNames

NetJoinDomain

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx