3.2.4.6.8 ModifyMachineInfo (Opnum 14)

  • Article

The ModifyMachineInfo method modifies a machine in a machine group. This method modifies the direct child machine with the specified machine ID under the specified parent machine group.

 [id(8), helpstring("method ModifyMachineInfo")] HRESULT ModifyMachineInfo(
   [in] BSTR bstrParentMachineGroupId,
   [in] BSTR bstrMachineId,
   [in] BSTR bstrMachineInfo
 );

bstrParentMachineGroupId: A string that specifies the identifier of the machine group that contains the machine to modify.<99>

If this parameter is NULL, E_INVALIDARG MUST be returned.

bstrMachineId: A string that specifies the identifier of the machine to modify.

If this parameter is NULL, E_INVALIDARG MUST be returned.

bstrMachineInfo: A string that specifies the new information for the machine, in the format specified in Machine element (section 2.2.5.17).

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.

0xC1FF0070

WRM_ERR_TAGS_NOT_IN_ORDER

The XML data that is maintained by the management service is invalid or cannot be processed.<100>

0xC1FF0389

WRM_ERR_MACHINEGROUPID_INVALID

The specified machine group ID is invalid.

0xC1FF038A

WRM_ERR_MACHINEID_INVALID

The specified machine ID is not found.<101>

0xC1FF038C

WRM_ERR_MACHINE_ALREADY_EXISTS

A machine with the specified machine name in the bstrMachineInfo XML already exists as the direct child in the machine group.<102>

Additional IWRMMachineGroup interface methods are specified in section 3.2.4.6.