Función NetUnjoinDomain (lmjoin.h)

  • Artículo

La función NetUnjoinDomain desconecta un equipo de un grupo de trabajo o un dominio.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fUnjoinOptions
);

Parámetros

[in] lpServer

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

[in] lpAccount

Puntero a una cadena constante que especifica el nombre de cuenta que se va a usar al conectarse al controlador de dominio. La cadena debe especificar un nombre netBIOS de dominio y una cuenta de usuario (por ejemplo, REDMOND\user) o el nombre principal de usuario (UPN) del usuario en forma de nombre de inicio de sesión de estilo Internet (por ejemplo, "someone@example.com"). 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] fUnjoinOptions

Especifica las opciones de desenlazación. Si este parámetro es NETSETUP_ACCT_DELETE, la cuenta se deshabilita cuando se produce la unión. Tenga en cuenta que esta opción no elimina la cuenta. Actualmente, no hay otras opciones de unión definidas.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es 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_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

La unión (y la unión) de un equipo a un dominio o grupo de trabajo solo la puede realizar un miembro del grupo local Administradores en el equipo de destino. Si llama a la función NetUnjoinDomain de forma remota, debe proporcionar credenciales porque no puede delegar las credenciales en estas circunstancias.

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

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

Requisitos

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

Consulte también

NetJoinDomain

NetRenameMachineInDomain

Funciones de administración de redes

Introducción a la administración de redes