Share via

3.2.4.6.1 CreateMachineGroup (Opnum 7)

  • Article

The CreateMachineGroup method creates and initializes a machine group.

 [id(1), helpstring("method CreateMachineGroup")] HRESULT CreateMachineGroup(
   [in] BSTR bstrParentMachineGroupId,
   [in] BSTR bstrMachineGroupInfo
 );

bstrParentMachineGroupId: A string that specifies the identifier of the parent machine group in which to create a new machine group.

If this parameter is NULL, E_INVALIDARG MUST be returned.

bstrMachineGroupInfo: A string that specifies information about the machine group to be created, including its identifier, in the format of a MachineGroup element (section 2.2.5.18).<85>

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.<86>

0xC1FF0385

WRM_ERR_MACHINE_GROUP_LIMIT_EXCEEDED

The total number of machine groups has exceeded an implementation-defined limit.<87>

0xC1FF0387

WRM_ERR_MACHINES_LIMIT_IN_MACHINEGROUP_EXCEEDED

The total number of machines directly under a machine group has exceeded an implementation-defined limit.<88>

0xC1FF0388

WRM_ERR_MACHINEGROUP_ALREADY_EXISTS

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

0xC1FF0389

WRM_ERR_MACHINEGROUPID_INVALID

The specified parent machine group id does not exist.

Additional IWRMMachineGroup interface methods are specified in section 3.2.4.6.