Prototyp und Beschreibung der Funktion getcoordsys()

(Funktion der freischaltpflichtigen Gruppe " Parameterermittlung")

getcoordsys()
Ermittlung der Bezeichnung, der Projektionsmethode und der
Projektionsparameter eines Koordinatensystems.

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

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getcoordsys(;
     wCoordSysQ as word,;                  // 2 Byte
     pszCoordSys ref psz);                 // 4 Byte, char**, 800 alloc.
as logic pascal:geodll32.getcoordsys       // 4 Byte

Die Allokation von Speicher für "ref psz" / "char**" ist nur notwendig,
wenn zuvor setstringallocate(FALSE) aufgerufen worden ist.


Die Funktion gibt die zum in wCoordSys übergebenen Koordinatensystem
passende Bezeichnung, Projektionsmethode sowie Bezeichnungen und Werte der
Projektionsparameter und weitere Werte als formatierten Text in der
Variablen pszCoordSys zurück. Der Text wird in der zuvor mit der Funktion
setLanguage() gesetzten Sprache zurückgegeben.


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

pszCoordSys Die Koordinatensystem-Parameter werden formatiert und mit
(ref)       einer Beschreibung versehen in einem Text per Referenz
            zurückgegeben. Die Zeilen des Textes sind mit "Return und
            LineFeed" voneinander getrennt.
            Achtung: "ref pszCoordSys" entspricht "char**" in C. Es müssen
            800 Byte Speicher für den Null terminated string in Abhängigkeit
            vom Aufruf der Funktion setstringallocate() allokiert werden.
            Beachten Sie dazu die Hinweise in der Beschreibung der Funktion
            setstringallocate()".

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


Der zurückgegebene formatierte Text sieht je nach dem gewählten
Koordinatensystem z.B. so aus:
   Französische Lambert Zone II (Zentral)
   Lambert Conformal Conic Projektion (1 SP)
   0002.3372292 Längengrad des Gitterursprungs [Grad]
   0046.8000000 Breitengrad der Standard-Paral. [Grad]
   000600000.00 Östliche Verschiebung [Meter]
   000200000.00 Nördliche Verschiebung [Meter]
   00.999877420 Maßstabsfaktor

   Bereichsgrenzen des Koordinatensystems:
   Länge -7 bis 12 Grad
   Breite 41 bis 52 Grad


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
keine Funktionsaufrufe möglich.