Prototyp und Beschreibung der Funktion getcoordstrstatus()

(Funktion der freischaltpflichtigen Gruppe " Parameterermittlung")

 

getcoordstrstatus()
Feststellen ob ein Koordinatensystem ein Streifensystem ist.

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

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


Die Funktion stellt fest, ob das in wCoordSys übergebene Koordinatensystem
ein Meridianstreifensystem (z.B. UTM, Gauß-Krüger) ist und gibt den Status
im Parameter lStatus zurück.


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

lStatus     Status "Meridianstreifensystem". Der Status wird per Referenz
(ref)       zurückgegeben.
TRUE        Das Koordinatensystem ist ein Meridianstreifensystem.
FALSE       Das Koordinatensystem ist kein Meridianstreifensystem.

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.