OV_Tools::AddToolGroup()
OV_Tools::AddToolGroup_Trans()

boolean AddToolGroup(

[in] string ToolGroupName)

boolean AddToolGroup_Trans(

[in] string TransId,

[in] string ToolGroupName)

Parameters

TransId

Transaction ID returned from OV_Transaction::Start().

ToolGroupName

The Name property of the instance of OV_Tools to be added to this tool group.

Calling Convention

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

Description

Adds a tool group (instance of OV_Tools) to this tool group as a child tool group.

The root tool group cannot be added to this node. (If it is, the method fails with MDLAPI_E_TOOLGROUP_IS_ROOT.) If the tool group with the name ToolGroupName is the same as this tool group or one of its parents (recursive until the Root tool group), the method fails with MDLAPI_E_TOOLGROUP_IS_ALREADY_PARENT.

Return Value

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

Extended Status Codes

MDLAPI_E_TOOLGROUP_NOT_EXIST

Tool Group does not exist.

MDLAPI_E_TOOLGROUP_HIERPATH_EXISTS

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

MDLAPI_E_TOOLGROUP_IS_ROOT

Root Tool Group cannot be removed from or added to another tool group.

MDLAPI_E_TOOLGROUP_IS_ALREADY_PARENT

Tool group already has a parent with the same name.

MDLAPI_E_TRANSACTION_NOT_EXIST

Transaction with the specified ID does not exist.