Méthode UnjoinDomainOrWorkgroup de la classe Win32_ComputerSystem

La méthode UnjoinDomainOrWorkgroup supprime un système informatique d’un domaine ou d’un groupe de travail.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

uint32 UnjoinDomainOrWorkgroup(
  [in] string Password,
  [in] string UserName,
  [in] uint32 FUnjoinOptions = 
);

Paramètres

Mot de passe [in]

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

Notes

Le mot de passe doit utiliser un niveau d’authentification élevé, au moins RPC_C_AUTHN_LEVEL_PKT_PRIVACY, lors de la connexion à Winmgmt ou CoSetProxyBlanket sur le pointeur IWbemServices . S’il est local dans Winmgmt, ce n’est pas un problème.

UserName [in]

Pointeur vers une chaîne de caractères constante terminée par un caractère null qui spécifie le nom de compte à utiliser lors de la connexion au contrôleur de domaine. Doit spécifier un domaine et un compte d’utilisateur, par exemple, « domaine\utilisateur » ou « user@domain ». Si ce paramètre a la valeur NULL, le contexte de l’appelant est utilisé.

Notes

UserName doit utiliser un niveau d’authentification élevé, au moins RPC_C_AUTHN_LEVEL_PKT_PRIVACY, lors de la connexion à Winmgmt ou CoSetProxyBlanket sur le pointeur IWbemServices . S’il est local dans Winmgmt, ce n’est pas un problème.

FUnjoinOptions [in]

Ensemble d’indicateurs de bits définissant les options de dissociation.

(0)

Par défaut. Aucune option.

NETSETUP_ACCT_DELETE (4)

Désactivez le compte Active Directory après l’opération de dissociation, mais ne supprimez pas le compte.

Valeur retournée

La méthode UnjoinDomainOrWorkgroup retourne 0 (zéro) en cas de réussite ou lorsqu’aucune option n’est impliquée. Toute autre valeur indique une erreur. Pour les codes d’erreur, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Réussite (0)

Autre (1 4294967295)

Notes

Après avoir appelé cette méthode, redémarrez l’ordinateur affecté pour appliquer les modifications.

Exemples

Dissocier un ordinateur d’un domaine L’exemple VBScript dissocie l’ordinateur local de son domaine actuel et désactive le compte d’ordinateur.

L’exemple de script Dissocier un ordinateur d’un domaine à l’aide de VBS dissocie un ordinateur spécifié d’un domaine. .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Win32_ComputerSystem

Méthode JoinDomainOrWorkgroup