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

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

Confira também

NetJoinDomain

NetRenameMachineInDomain

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede