Prototyp und Beschreibung der Funktion getcoordname()

(Funktion der freischaltpflichtigen Gruppe "Parameterermittlung")

getcoordname()
Ermittlung der Bezeichnung eines Koordinatensystems.

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

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getcoordname(;
     wCoordSys as word,;                   // 2 Byte
     pszCoordName ref psz);                // 4 Byte, char**, 80 alloc.
as logic pascal:geodll32.getcoordname      // 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 Bezeichnung des in wCoordSys übergebenen
Koordinatensystems als Text im Parameter pszCoordName 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 Bezeichnung ermittelt werden
            soll. Die verfügbaren Koordinatensysteme sind in der
            Liste "Koordinatenbezugssysteme" aufgeführt.

pszCoordName Die Bezeichnung des Koordinatensystems wird per Referenz
(ref)       zurückgegeben.
            Achtung: "ref pszCoordName" entspricht "char**" in C. Es müssen
            80 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 Text sieht je nach dem gewählten Koordinatensystem etwa
so aus:
   Schweizer Landeskoordinaten (LV03)
      oder
   Belgische Lambert72 Koordinaten


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.