Função NetSetPrimaryComputerName (lmjoin.h)

Artigo
03/05/2024

A função NetSetPrimaryComputerName define o nome do computador primário para o computador especificado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR PrimaryName,
  [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] PrimaryName

Um ponteiro para uma cadeia de caracteres constante que especifica o nome primário a ser definido. 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.

Retornar valor

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	Acesso 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 PrimaryName 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 NetSetPrimaryComputerName tem suporte no Windows XP e posterior.

A função NetSetPrimaryComputerName é usada como parte das operações de renomeação do computador. O nome especificado será removido da lista de nomes alternativos configurada para o computador de destino e configurada como o nome primário. O nome da conta do computador será alterado para corresponder ao nome primário. O nome do computador primário anterior é movido para a lista de nomes de computador alternativos configurada para o computador.

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

Requisitos

Requisito	Valor
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