Prototyp und Beschreibung der Funktion getelltarget()

(Funktion der freischaltpflichtigen Gruppe "Parameterermittlung")

 

getelltarget()
Ermittlung der Halbachsen des dem Zielbezugssystem zugeordneten geodätischen
Ellipsoids.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall getelltarget(
     unsigned short wEllipsoid,
     double *nMajorSemi,
     double *nMinorSemi);

Prototyp der DLL-Funktion 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


Die Funktion ermittelt die Halbachsen eines dem Zielbezugssystem
zugeordneten Ellipsoids. Jedem Bezugssystem ist intern ein vordefinierter
Ellipsoid fest zugeordnet.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
wEllipsoid  Kennung des Ellipsoids, für den die Halbachsen ermittelt
            werden sollen.
            Die Ellipsoide sind im unteren Bereich der Liste
            "Systeme alphabetisch sortiert" aufgeführt. Es können auch
            die Nummern der in der Liste "Systeme nach Ländern sortiert"
            aufgeführten Bezugssysteme verwendet werden.

nMajorSemi  Referenz auf die große Halbachse des Zielellipsoids in
(ref)       Meter.

nMinorSemi  Referenz auf die kleine Halbachse des Zielellipsoids in
(ref)       Meter.

returnWert  Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE.


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"Parameterermittlung". Sie wird zusammen mit den anderen Funktionen
der Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen
Freischaltparameter per Aufruf der Funktion setunlockcode() zur
uneingeschränkten Nutzung frei geschaltet. Ohne die Freischaltung sind nur
wenige Funktionsaufrufe zu Testzwecken (Sharewareprinzip) möglich.