Creates a group in the Information Window.
HRESULT CreateGroup (
[in] BSTR GroupName,
[in, defaultvalue(0)] long ParentGroupID,
[out, retval] long *pVal)
Parameters:
GroupName – Name assigned to the group being created.
ParentGroupID – Allows the user to specify under which parent group, within the Information Tree, the group should be created. The default is set to zero meaning, if unspecified, the group is created in the root of the tree. The ParentGroupID must be a valid group id.
pVal – Once the method call is returned, pVal contains the ID of the group being created.
Return Values:
The return value obtained from the returned HRESULT can be one of the following:
|
Return value |
Meaning |
|
S_OK |
Success. |
|
E_FAIL |
Catastrophic failure. |
|
TE_E_MPTNOTLOADED |
An MPT file must be loaded in TerraExplorer for this method to work. |
|
TE_E_INFOTREE_PARENTNOTGROUP |
The ParentGroupID entered is not a valid group id. |
|
TE_E_NOLICENSE |
You are running TerraExplorer Viewer and therefore do not have permissions to work with this interface. |