UnjoinDomainOrWorkgroup method of the Win32_ComputerSystem class

Article
11/09/2023

The UnjoinDomainOrWorkgroup method removes a computer system from a domain or workgroup.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

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

Parameters

Password [in]: If the UserName parameter specifies an account name, the Password parameter must point to the password to use when connecting to the domain controller. Otherwise, this parameter must be NULL.

Note

Password must use a high authentication level, not less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY, when connecting to Winmgmt or CoSetProxyBlanket on the IWbemServices pointer. If local to Winmgmt, this is not a concern.
UserName [in]: Pointer to a constant null-terminated character string that specifies the account name to use when connecting to the domain controller. Must specify a domain and user account, for example, "domain\user" or "user@domain". If this parameter is NULL, the caller context is used.

Note

UserName must use a high authentication level, not less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY, when connecting to Winmgmt or CoSetProxyBlanket on the IWbemServices pointer. If local to Winmgmt, this is not a concern.
FUnjoinOptions [in]: Set of bit flags defining the unjoin options.
(0): Default. No options.
NETSETUP_ACCT_DELETE (4): Disable the Active Directory account after the unjoin operation, but do not delete the account.

Return value

The UnjoinDomainOrWorkgroup method returns 0 (zero) on success or when no options are involved. Any other value indicates an error. For error codes, see WMI Error Constants or WbemErrorEnum. For general HRESULT values, see System Error Codes.

Success (0)
Other (1 4294967295)

Remarks

After calling this method, restart the affected computer to apply the changes.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll