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.