Rename method of the Win32_UserAccount class
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 |
|
| DLL |
|