HP Operations Manager for Windows

OV_NodeGroup::RemoveNodeGroup()
OV_NodeGroup::RemoveNodeGroup_Trans()


void RemoveNodeGroup(
[in] string NodeGroupName)
void RemoveNodeGroup_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 removed from this node group.

Calling Convention

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

Description

Removes a child node group (instance of OV_NodeGroup) from this node group.

You cannot remove special node groups (the method fails with MDLAPI_E_NODEGROUP_IS_SPECIAL_GROUP). You cannot remove a node group from a special node group (the method fails with MDLAPI_E_NODEGROUP_SPECIAL_REMOVE).

Caution CAUTION:
If a node group no longer belongs to any node group after this operation, it is removed from STORE. To find out what else is removed when the node group is removed, see the description of the Remove class method.

Return Value

None.

Extended Status Codes

MDLAPI_E_NODE_IS_MANAGEMENT_SERVER
Management server cannot be removed.
MDLAPI_E_NODEGROUP_NOT_EXIST
Node Group does not exist.
MDLAPI_E_NODEGROUP_IS_SPECIAL_GROUP
Special Node Group cannot be removed from or added to another node group.
MDLAPI_E_NODEGROUP_SPECIAL_REMOVE
Child cannot be removed from a special node group.
MDLAPI_E_TRANSACTION_NOT_EXIST
Transaction with the specified ID does not exist.