The Rename WMI class method renames a user account name.
This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.
Syntax
uint32 Rename(
[in] string Name
);
Parameters
Name [in]
New account name.
Return value
Returns one of the values listed in the following list. For additional error codes, see WMI Error Constants or WbemErrorEnum. For general HRESULT values, see System Error Codes.
Success
0
Success.
Instance not found
1
Instance not found.
Instance required
2
Instance required.
Invalid parameter
3
Invalid parameter.
User not found
4
User not found.
Domain not found
5
Domain not found.
Operation is allowed only on the primary domain controller of the domain
6
Operation is allowed only on the primary domain controller of the domain.
Operation is not allowed on the last administrative account.
7
Operation is not allowed on specified special groups; user, admin, local or guest.
8
Operation is not allowed on specified special groups: user, admin, local, or guest.
Other API error
9
Other API error.
Internal error
10
Internal error.
Remarks
This functionality is implemented as a method to provide a separate context for the new name that is distinguishable from the key property value for Name that is associated with the instance to be modified.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Namespace | Root\CIMV2 |
| MOF | CIMWin32.mof |
| DLL | CIMWin32.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
