HRESULT Return Values

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.