Función NetUnjoinDomain (lmjoin.h)
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 |
|---|---|
|
Un parámetro es incorrecto. |
|
El equipo no está unido actualmente a un dominio. |
|
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 |