OV_NodeGroup::AddExternalNode()
OV_NodeGroup::AddExternalNode_Trans()

boolean AddExternalNode(

[in] string NodeName)

boolean AddExternalNode_Trans(

[in] string TransId,

[in] string NodeName)

Parameters

TransId

Transaction ID returned from OV_Transaction::Start().

NodeName

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

Calling Convention

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

Description

Adds an external node (instance of OV_ExternalNode) to this node group as a child node.

You cannot add an external node to a special node group (the method fails with MDLAPI_E_NODEGROUP_SPECIAL_ADD).

Return Value

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

Extended Status Codes

MDLAPI_E_EXT_NODE_NOT_EXIST

External node does not exist.

MDLAPI_E_EXT_NODE_HIERPATH_EXISTS

External node with the same hierarchy path (Caption) already exists.

MDLAPI_E_NODEGROUP_SPECIAL_ADD

Child cannot be added to a special node group.

MDLAPI_E_TRANSACTION_NOT_EXIST

Transaction with the specified ID does not exist.