This method sets the coordinate system that the client application is working in. After setting it, every coordinate used by this client is converted to the terrain coordinate system. You can retrieve the terrain coordinate system with ICoordSys::GetTerrainCS(). This method should be used once, to define the coordinate system used by the client application, or each time the client switches to a different coordinate system.
HRESULT SetSourceCS(
[in] BSTR GroupKey,
[in] BSTR SystemKey,
[in] BSTR DatumKey,
[in] BSTR UnitKey,
[in] long EPSG)
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.
EPSG – Reserved.
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. |
|
TE_E_COORDSYS_NOT_INIT |
Reprojection error. The key component geocalc.dat may be missing |