3.2.4.6.5 RenameMachineGroup (Opnum 11)

  • Article

The RenameMachineGroup method changes the name of an existing machine group.

 [id(5), helpstring("method RenameMachineGroup")] HRESULT RenameMachineGroup(
   [in] BSTR bstrOldMachineGroupName,
   [in] BSTR bstrNewMachineGroupName
 );

bstrOldMachineGroupName: A string that specifies the identifier of the machine group to be renamed.

If this parameter is NULL, E_INVALIDARG MUST be returned.

bstrNewMachineGroupName: A string that specifies the new identifier of the machine group.

If this parameter is NULL, E_INVALIDARG MUST be returned.

Return Values: This method returns 0x00000000 for success or a negative HRESULT value (in the following table or in [MS-ERREF] section 2.1.1) if an error occurs.

Return value/code

Description

0x00000000

S_OK

Operation successful.

0x80070057

E_INVALIDARG

One or more arguments are invalid.

0xC1FF0388

WRM_ERR_MACHINEGROUP_ALREADY_EXISTS

A machine group with the specified name already exists in the entire WSRM configuration.

0xC1FF0389

WRM_ERR_MACHINEGROUPID_INVALID

The specified machine group id is invalid.

Additional IWRMMachineGroup interface methods are specified in section 3.2.4.6.