OV_NodeGroup::Remove()
OV_NodeGroup::Remove_Trans()
- void Remove(
- [in] string Name)
- void Remove_Trans(
- [in] string TransId,
- [in] string Name)
Parameters
- TransId
- Transaction ID returned from OV_Transaction::Start().
- Name
- The Name property of the instance of OV_NodeGroup to be
removed.
Calling Convention
These methods can be called from a WMI class or instance
object.
Description
Removes the specified node group (instance of OV_NodeGroup).
CAUTION:
This method also removes all child node groups that are not
contained in any other node group (except special node groups). If
nodes that are contained in this node group are not contained in
any other node group (except special node groups), they are also
removed. (To find out what else is removed, see the description of
the Remove class method of OV_ManagedNode.) If the management
server is also removed, the method fails with
MDLAPI_E_NODE_IS_MANAGEMENT_SERVER. In addition, associated reports
and associations to Auto-Deploy policies and tools are removed.
(Only associations, not objects, are removed.)
NOTE:
You cannot remove root or special node groups. Attempts fail with
MDLAPI_E_NODEGROUP_IS_ROOT /
MDLAPI_E_NODEGROUP_IS_SPECIAL_GROUP.
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_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_TRANSACTION_NOT_EXIST
- Transaction with the specified ID does not exist.