Returns the position and orientation of the object.
HRESULT GetPosition(
[out] VARIANT* doubleX,
[out] VARIANT* doubleY,
[out] VARIANT* doubleElevation,
[out] VARIANT* doubleYaw,
[out] VARIANT* doublePitch,
[out] VARIANT* doubleRoll)
Parameters:
doubleX – The West-East coordinate of the waypoint in MPT units. You can use the ITerrain interface to retrieve information about the MPT units. If you are working in Lat-Long format, the Lat-Long values are in decimal Lat-Long.
doubleY – The North-South coordinate of the waypoint in MPT units. You can use the ITerrain interface to retrieve information about the MPT units. If you are working in Lat-Long format, the Lat-Long values are in decimal Lat-Long.
doubleElevation – The altitude of the location, in the default altitude type of the object. You can get the default altitude type by using the ITerrainLocation5::GetPositionEx() method.
doubleYaw – The Yaw angle of the object. See: “Yaw, Pitch and Roll Angles”.
doublePitch – The Pitch angle of the object. See: “Yaw, Pitch and Roll Angles”.
doubleRoll – The Roll angle of the object. See: “Yaw, Pitch and Roll Angles”.
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_TEOBJECT_NOLONGEREXIST |
The object you are trying to access no longer exists. This may have occurred because, while keeping an interface to the object, the user deleted it from TerraExplorer (via the TE user interface). Without the object, the interface cannot be used. Therefore, you should release the interface. |
|
TE_E_INTERNAL |
TerraExplorer was unable to create the object. To get more information about this error use the IErrorInfo Interface. |