Prototyp und Beschreibung der Funktion getrefname()

(Funktion der freischaltpflichtigen Gruppe " Parameterermittlung")

getrefname()
Ermittlung der Bezeichnung eines geodätischen Bezugssystems.

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

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getrefname(;
     wRefSys as word,;                     // 2 Byte
     pszRefName ref psz);                  // 4 Byte, char**, 80 alloc.
as logic pascal:geodll32.getrefname        // 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 wRefSys übergebenen geodätischen
Bezugssystems als Text im Parameter pszRefName 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:
wRefSys     Geodätisches Bezugssystem, für das die Bezeichnung ermittelt
            werden soll. Die verfügbaren Bezugssysteme sind in der Liste
            "Koordinatenbezugssysteme" aufgeführt.

pszRefName  Die Bezeichnung des geodätischen Bezugssystems wird per
(ref)       Referenz zurückgegeben.
            Achtung: "ref pszRefName" entspricht "char**" in C. Es müssen
            80 Bytes 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 Bezugssystem etwa
so aus:
   ETRS89 (Europa), geozentrisch, GRS80
      oder
   NAD27 (US West), Meade's Ranch Kansas, Clarke


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.