This method returns a handle to a coordinate system. You can use this handle to define parameters for the ICoordSys::Reproject() method. After the handle has been used, it should be released using ICoordSys::ReleaseCSHandle().
HRESULT GetCSHandle(
[in] BSTR GroupKey,
[in] BSTR SystemKey,
[in] BSTR DatumKey,
[in] BSTR UnitKey,
[out] VARIANT* longCSHandle)
Parameters:
GroupKey – The unique string of the coordinate system group.
SystemKey – The unique string of the coordinate system.
DatumKey – The unique string of the coordinate system datum.
UnitKey – The unique string of the coordinate system units.
longCSHandle – Handle to coordinate system.
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_COORDSYS_NOT_INIT |
Reprojection error. The key component geocalc.dat may be missing |
|
TE_E_NOLICENSE |
You are running TerraExplorer Viewer and therefore do not have permission to work with this interface. |