Rename method
Collapse the table of content
Expand the table of content

Rename method of the Win32_UserAccount class

The RenameWMI 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 table. For additional error codes, see WMI Error Constants or WbemErrorEnum. For general HRESULT values, see System Error Codes.

Return code/valueDescription
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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Win32_UserAccount
Operating System Classes

 

 

Show:
© 2016 Microsoft