OV_NodeGroup::AddNodeGroup()
OV_NodeGroup::AddNodeGroup_Trans()

boolean AddNodeGroup(

[in] string NodeGroupName)

boolean AddNodeGroup_Trans(

[in] string TransId,

[in] string NodeGroupName)

Parameters

TransId

Transaction ID returned from OV_Transaction::Start().

NodeGroupName

The Name property of the instance of OV_NodeGroup to be added to this node group.

Calling Convention

These methods can be called only from a WMI instance object.

Description

Adds a node group (instance of OV_NodeGroup) to this node group as a child node group.

You cannot add node groups to a special node group (the method fails with MDLAPI_E_NODEGROUP_SPECIAL_ADD). You cannot add root or special node groups to this node (the method fails with MDLAPI_E_NODEGROUP_IS_ROOT / MDLAPI_E_NODEGROUP_IS_SPECIAL_GROUP).

If a node group with the name NodeGroupName is the same as this node group, or if it is one of its parents (recursive until the Root node group), the method fails with MDLAPI_E_NODEGROUP_IS_ALREADY_PARENT.

Return Value

False if the node group is already a child of this node group.

Extended Status Codes

MDLAPI_E_NODEGROUP_NOT_EXIST

Node Group does not exist.

MDLAPI_E_NODEGROUP_HIERPATH_EXISTS

Node Group with the same hierarchy path (Caption) already exists.

MDLAPI_E_NODEGROUP_IS_ROOT

Root Node Group cannot be removed from or added to another node group.

MDLAPI_E_NODEGROUP_IS_SPECIAL_GROUP

Special Node Group cannot be removed from or added to another node group.

MDLAPI_E_NODEGROUP_SPECIAL_ADD

Child cannot be added to a special node group.

MDLAPI_E_NODEGROUP_IS_ALREADY_PARENT

Node group already has a parent with the same name.

MDLAPI_E_TRANSACTION_NOT_EXIST

Transaction with the specified ID does not exist.