NetUnjoinDomain, fonction (lmjoin.h)
La fonction NetUnjoinDomain dissocie un ordinateur d’un groupe de travail ou d’un domaine.
NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
[in] LPCWSTR lpServer,
[in] LPCWSTR lpAccount,
[in] LPCWSTR lpPassword,
[in] DWORD fUnjoinOptions
);
[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.
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 |
---|---|
|
Un paramètre est incorrect. |
|
L’ordinateur n’est actuellement pas joint à un domaine. |
|
Cet ordinateur est un contrôleur de domaine et ne peut pas être dissocié d’un domaine. |
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.
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 |