Función NetRenameMachineInDomain (lmjoin.h)

Artículo
03/14/2023

La función NetRenameMachineInDomain cambia el nombre de un equipo en un dominio.

Sintaxis

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

Puntero a una cadena constante que especifica el nombre DNS o NetBIOS del equipo en el que se va a llamar a la función. Si este parámetro es NULL, se usa el equipo local.

[in] lpNewMachineName

Puntero a una cadena constante que especifica el nuevo nombre del equipo. Si se especifica, también se cambia el nombre del equipo local. Si este parámetro es NULL, la función supone que ya ha llamado a la función SetComputerNameEx .

[in] lpAccount

Puntero a una cadena constante que especifica un nombre de cuenta que se va a usar al conectarse al controlador de dominio. Si este parámetro es NULL, se usa el contexto del autor de la llamada.

[in] lpPassword

Si el parámetro lpAccount especifica un nombre de cuenta, este parámetro debe apuntar a la contraseña que se usará al conectarse al controlador de dominio. De lo contrario, este parámetro debe ser NULL.

[in] fRenameOptions

Opciones de cambio de nombre. Si este parámetro es NETSETUP_ACCT_CREATE, la función cambia el nombre de la cuenta en el dominio.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error o uno de los códigos de error del sistema.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	Se denegó el acceso. Este error se devuelve si el nombre de cuenta pasado en el parámetro lpAccount no tenía suficientes derechos de acceso para la operación.
ERROR_INVALID_PARAMETER	Un parámetro es incorrecto.
NERR_SetupNotJoined	El equipo no está unido actualmente a un dominio.
NERR_SetupDomainController	Este equipo es un controlador de dominio y no se puede separar de un dominio.

Comentarios

El cambio de nombre de un equipo de dominio solo lo puede realizar un usuario que sea miembro del grupo local Administradores en el equipo de destino y que también sea miembro del grupo Administradores en el dominio o que tenga el privilegio Operador de cuenta en el dominio. Si llama a la función NetRenameMachineInDomain de forma remota, debe proporcionar credenciales porque no puede delegar credenciales en estas circunstancias.

Los distintos procesos, o subprocesos diferentes del mismo proceso, no deben llamar a la función NetRenameMachineInDomain al mismo tiempo. Esta situación puede dejar el equipo en un estado incoherente.

Los valores devueltos NERR_SetupNotJoined y NERR_SetupDomainController se definen en el archivo de encabezado Lmerr.h. El archivo de encabezado Lm.h incluye automáticamente este archivo de encabezado y no debe incluirse directamente.

Se requiere un reinicio del sistema después de llamar a la función NetRenameMachineInDomain para que se complete la operación.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmjoin.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll