Função NetRenameMachineInDomain (lmjoin.h)

Artigo
08/24/2023

A função NetRenameMachineInDomain altera o nome de um computador em um domínio.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpNewMachineName,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fRenameOptions
);

Parâmetros

[in] lpServer

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

[in] lpNewMachineName

Um ponteiro para uma cadeia de caracteres constante que especifica o novo nome do computador. Se especificado, o nome do computador local também será alterado. Se esse parâmetro for NULL, a função pressupõe que você já tenha chamado a função SetComputerNameEx .

[in] lpAccount

Um ponteiro para uma cadeia de caracteres constante que especifica um nome de conta a ser usado ao se conectar ao controlador de domínio. Se esse parâmetro for NULL, o contexto do chamador será usado.

[in] lpPassword

Se o parâmetro lpAccount especificar um nome de conta, esse parâmetro deverá apontar para a senha a ser usada ao se conectar ao controlador de domínio. Caso contrário, esse parâmetro deve ser NULL.

[in] fRenameOptions

As opções de renomeação. Se esse parâmetro for NETSETUP_ACCT_CREATE, a função renomeará a conta no domínio.

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 nome da conta passado no parâmetro lpAccount não tiver direitos de acesso suficientes para a operação.
ERROR_INVALID_PARAMETER	Um parâmetro está incorreto.
NERR_SetupNotJoined	No momento, o computador não está ingressado em um domínio.
NERR_SetupDomainController	Este computador é um controlador de domínio e não pode ser desvinculado de um domínio.

Comentários

Renomear um computador de domínio só pode ser executado por um usuário que seja membro do grupo local Administradores no computador de destino e que também seja membro do grupo Administradores no domínio ou tenha o privilégio operador de conta no domínio. Se você chamar a função NetRenameMachineInDomain remotamente, deverá fornecer credenciais porque não é possível delegar credenciais nessas circunstâncias.

Processos diferentes ou threads diferentes do mesmo processo não devem chamar a função NetRenameMachineInDomain ao mesmo tempo. Essa situação pode deixar o computador em um estado inconsistente.

Os valores retornados NERR_SetupNotJoined e NERR_SetupDomainController são definidos no arquivo de cabeçalho Lmerr.h. Esse arquivo de cabeçalho é incluído automaticamente pelo arquivo de cabeçalho Lm.h e não deve ser incluído diretamente.

Uma reinicialização do sistema é necessária depois de chamar a função NetRenameMachineInDomain para que a operação seja concluída.

Requisitos


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