All COM methods return an unsigned integer called an HRESULT that tells whether the method succeeded or failed and provides additional information about the outcome of the operation.
The return value obtained from the returned HRESULT of TerraExplorer calls can be one of the following:
|
Return value |
Meaning |
|
S_OK |
Success. |
|
E_FAIL |
Catastrophic failure. |
|
TE_E_INTERNAL |
TerraExplorer was unable to create the object. To get more information about this error use IErrorInfo Interface. |
|
TE_E_NOLICENCE |
Your license does not allow the use of this feature. |
|
TE_E_MPTNOTLOADED |
A terrain database file must be loaded in TerraExplorer for this method to work. |
|
For operations involving objects, the following HRESULTS are also returned: |
|
|
TE_E_TEOBJECT_NOLONGEREXIST |
The object you are trying to access no longer exists. This may have occurred because, while keeping an interface to the object/feature, the user deleted it from TerraExplorer (via the TerraExplorer user interface) or the feature was removed by the streaming mechanism. Without the object, the interface cannot be used. Therefore, you should release the interface. |
|
TE_E_OBJMANAGER_OBJNOTFOUND |
The requested object was not found. |