The GetTerraObjectID method uses ItemID to retrieve the actual object ID associated with this tree item ID entry. While ItemID can change while working with TerraExplorer Pro, and when reloading the .Fly file, ObjectID always stays the same.
Supported by TerraExplorer Viewer.
HRESULT GetTerraObjectID (
[in] long ItemID,
[out, retval] BSTR *pVal)
Parameters:
ItemID – The Information Tree ID of the object to be found.
pVal – Once the method call is returned, pVal contains the TerraObjectID of the object (if the method call succeeds and ItemID is empty, it means that no real ITerraObject-derived object is associated with the given ItemID).
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_NOLICENSE |
You are running TerraExplorer Viewer and therefore do not have permission to work with this interface. |
Remarks: