Prototype and description of the function getelltarget()

(Function of the unlock requiring group "Parameter determination")

 

getelltarget()
Determination of the semi axes of the geodetic ellipsoid connected with the
target Reference System.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall getelltarget(
     unsigned short wEllipsoid,
     double *nMajorSemi,
     double *nMinorSemi);

Prototype of the DLL function in Visual Objects syntax:
_DLL function getelltarget(;
     wEllipsoid as word,;                  // 2 Byte
     nMajorSemi ref real8,;                // 4 Byte
     nMinorSemi ref real8);                // 4 Byte
as logic pascal:geodll32.getelltarget      // 4 Byte


The function determines the semi axes of a geodetic ellipsoid connected with
the target Reference System. Each referencd system is internal connected
with a pre-defined geodetic ellipsoid.


The parameters are passed and/or returned as follows:
wEllipsoid  Ellipsoid, for which the semi axes are to be determined.
            The ellipsoid numbers are specified at the bottom part of
            the list "Systems sorted alphabetical". The numbers of
            the Reference Systems specified in the list
            "Systems sorted by countries" can be used also.

nMajorSemi  The semi-major axis of the target ellipsoid in meters by
(ref)       reference.

nMinorSemi  The semi-minor axis of the target ellipsoid in meters by
(ref)       reference.


returnVal   In case of an error the function returns FALSE, otherwise TRUE.


Unlocking
This function is a component of the unlock requiring function group
"parameter determination". It is unlocked for unrestricted use together with
the other functions of the group by passing the unlock parameters, acquired
from the software distribution company, trough the function setunlockcode().
Without unlocking only a few function calls for test purposes (shareware
principle) are possible.