NetUnjoinDomain, fonction (lmjoin.h)

Article
02/28/2024

La fonction NetUnjoinDomain dissocie un ordinateur d’un groupe de travail ou d’un domaine.

Syntaxe

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

Paramètres

[in] lpServer

Pointeur vers une chaîne constante qui spécifie le nom DNS ou NetBIOS de l’ordinateur sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] lpAccount

Pointeur vers une chaîne constante qui spécifie le nom de compte à utiliser lors de la connexion au contrôleur de domaine. La chaîne doit spécifier un nom de domaine NetBIOS et un compte d’utilisateur (par exemple, REDMOND\user) ou le nom d’utilisateur principal (UPN) de l’utilisateur sous la forme d’un nom de connexion de style Internet (par exemple, «someone@example.com »). Si ce paramètre a la valeur NULL, le contexte de l’appelant est utilisé.

[in] lpPassword

Si le paramètre lpAccount spécifie un nom de compte, ce paramètre doit pointer vers le mot de passe à utiliser lors de la connexion au contrôleur de domaine. Sinon, ce paramètre doit avoir la valeur NULL.

[in] fUnjoinOptions

Spécifie les options de dissociation. Si ce paramètre est NETSETUP_ACCT_DELETE, le compte est désactivé lorsque l’annulation se produit. Notez que cette option ne supprime pas le compte. Actuellement, aucune autre option d’annulation n’est définie.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants ou l’un des codes d’erreur système.

Code de retour	Description
ERROR_INVALID_PARAMETER	Un paramètre est incorrect.
NERR_SetupNotJoined	L’ordinateur n’est actuellement pas joint à un domaine.
NERR_SetupDomainController	Cet ordinateur est un contrôleur de domaine et ne peut pas être dissocié d’un domaine.

Remarques

La dissociation (et la jointure) d’un ordinateur à un domaine ou à un groupe de travail ne peuvent être effectuées que par un membre du groupe local Administrateurs sur l’ordinateur cible. Si vous appelez la fonction NetUnjoinDomain à distance, vous devez fournir des informations d’identification, car vous ne pouvez pas déléguer d’informations d’identification dans ces circonstances.

Différents processus, ou différents threads du même processus, ne doivent pas appeler la fonction NetUnjoinDomain en même temps. Cette situation peut laisser l’ordinateur dans un état incohérent.

Un redémarrage du système est nécessaire après l’appel de la fonction NetRenameMachineInDomain pour que l’opération se termine.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmjoin.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Voir aussi

NetJoinDomain

NetRenameMachineInDomain

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau