Prototyp und Beschreibung der Funktion getellsource()

(Funktion der freischaltpflichtigen Gruppe "Parameterermittlung")

 

getellsource()
Ermittlung der Halbachsen des dem Quellbezugssystem zugeordneten
geodätischen Ellipsoids.

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

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getellsource(;
     wEllipsoid as word,;                  // 2 Byte
     nMajorSemi ref real8,;                // 4 Byte
     nMinorSemi ref real8);                // 4 Byte
as logic pascal:geodll32.getellsource      // 4 Byte


Die Funktion ermittelt die Halbachsen eines dem Quellbezugssystem
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 das 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 Quellellipsoids in
(ref)       Meter.

nMinorSemi  Referenz auf die kleine Halbachse des Quellellipsoids 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.