Lire en anglais

Partager via


NetUnjoinDomain, fonction (lmjoin.h)

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