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

See also

Win32_UserAccount

Operating System Classes