Função NetUnjoinDomain (lmjoin.h)
A função NetUnjoinDomain desvincula um computador de um grupo de trabalho ou de um domínio.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
[in] LPCWSTR lpServer,
[in] LPCWSTR lpAccount,
[in] LPCWSTR lpPassword,
[in] DWORD fUnjoinOptions
);
Parâmetros
[in] lpServer
Um ponteiro para uma cadeia de caracteres constante que especifica o nome DNS ou NetBIOS do computador no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.
[in] lpAccount
Um ponteiro para uma cadeia de caracteres constante que especifica o nome da conta a ser usado ao se conectar ao controlador de domínio. A cadeia de caracteres deve especificar um nome NetBIOS de domínio e uma conta de usuário (por exemplo, REDMOND\user) ou o NOME UPN do usuário na forma de um nome de logon no estilo internet (por exemplo, "someone@example.com"). 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] fUnjoinOptions
Especifica as opções de unjoin. Se esse parâmetro for NETSETUP_ACCT_DELETE, a conta será desabilitada quando o unjoin ocorrer. Observe que essa opção não exclui a conta. Atualmente, não há outras opções de unjoin definidas.
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 códigos de erro a seguir ou um dos códigos de erro do sistema.
| Código de retorno | Descrição |
|---|---|
|
Um parâmetro está incorreto. |
|
No momento, o computador não está ingressado em um domínio. |
|
Este computador é um controlador de domínio e não pode ser desvinculado de um domínio. |
Comentários
A desvinculação (e a junção) de um computador a um domínio ou grupo de trabalho só pode ser executada por um membro do grupo local Administradores no computador de destino. Se você chamar a função NetUnjoinDomain 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 NetUnjoinDomain ao mesmo tempo. Essa situação pode deixar o computador em um estado inconsistente.
Uma reinicialização do sistema é necessária depois de chamar a função NetRenameMachineInDomain para que a operação seja concluída.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |