Prototyp und Beschreibung der Funktion getcoordfixref()

(Funktion der freischaltpflichtigen Gruppe " Parameterermittlung")

 

getcoordfixref()
Feststellen ob ein Koordinatensystem ein fest zugeordnetes Bezugssystem hat.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall getcoordfixref(
     unsigned short wCoordSys,
     unsigned long *lIsFixed);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getcoordfixref(;
     wCoordSys as word,;                   // 2 Byte
     lIsFixed ref logic);                  // 4 Byte
as logic pascal:geodll32.getcoordfixref    // 4 Byte


Die Funktion ermittelt, ob das in wCoordSys übergebene Koordinatensystem
ein fest zugeordnetes Bezugssystem hat und gibt den Status im Parameter
lIsFixed zurück. Fest zugeordnete Bezugssysteme sind zum Beispiel bei den
deutschen "Lagestatus"-Systemen oder bei den Google Weltkoordinaten-Systemen
üblich.

Das für das Koordinatensystem fest eingestellte Bezugssystem kann durch
Abfrage des voreingestellten Standard-Bezugssystems mit der Funktion
getcoordstdrefsys() ermittelt werden.

GeoDLL verwendet das fest eingestellte Bezugssystem nicht automatisch. Auch
wenn das Flag lIsFixed gesetzt ist, können beliebige Bezugssysteme in den
Funktionen coordtrans???() eingestellt werden. Durch Abfrage des Status
"Fest zugeordnetes Bezugssystem" mit der Funktion getcoordfixref() kann das
aufrufende Programm aber reagieren. So kann das Programm beispielsweise nur
das mit der Funktion getcoordstdrefsys() zu ermittelnde Standard-
Bezugssystem zulassen.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
wCoordSys   Koordinatensystem, für das der Status eines fest zugeordneten
            Bezugssystems ermittelt werden soll. Die verfügbaren
            Koordinatensysteme sind in der Liste "Koordinatenbezugssysteme"
            aufgeführt.

lIsFixed    Status "Fest zugeordnetes Bezugssystem". Der Status wird per
(ref)       Referenz zurückgegeben.
TRUE        Das Koordinatensystem hat ein fest zugeordnetes Bezugssystem.
FALSE       Das Koordinatensystem hat kein fest zugeordnetes Bezugssystem.

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.