Prototyp und Beschreibung der Funktion getcoordstdrefsys()

(Funktion der freischaltpflichtigen Gruppe " Parameterermittlung")

getcoordstdrefsys()
Ermittlung des voreingestellten Standard-Bezugssystems für ein
Koordinatensystem.

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

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getcoordstdrefsys(;
     wCoordSys as word,;                   // 2 Byte
     pszRefSys ref psz,;                   // 4 Byte, char**, 80 alloc.
     wRefSys ref word);                    // 4 Byte
as logic pascal:geodll32.getcoordstdrefsys // 4 Byte

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


Die Funktion gibt das üblicherweise für ein Koordinatensystem verwendete
und in GeoDLL als Standard eingestellte Bezugssystem als Bezeichnung und
als Nummer an das rufende Programm zurück. Die Bezeichnung 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 ein Standard-Bezugssystem
            ermittelt werden soll. Die verfügbaren Koordinatensysteme
            sind in der Liste "Koordinatenbezugssysteme" aufgeführt.

pszRefSys   Standard-Bezugssystem, das innerhalb der GeoDLL für das
(ref)       übergebene Koordinatensystem vorgesehen ist, in
            alphanumerischer Kurzform.
            Achtung: "ref pszRefSys" 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 im Kapitel
            "Prototyp und Beschreibung der Funktion setstringallocate()".

wRefSys     Standard-Bezugssystem, das innerhalb der GeoDLL für das
(ref)       übergebene Koordinatensystem vorgesehen ist, als Nummer. Die
            Nummer korrespondiert zu den Bezugssystemen, die in der Liste
            "Koordinatenbezugssysteme" aufgeführt sind.

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


Das als Text zurückgegebene Standard-Bezugssystem und die korrespondierende
Nummer sehen je nach dem gewählten Koordinatensystem etwa so aus:
   für UTM (nördliche Hemisphäre) Koordinaten:
      WGS84   10
   oder für Britische Transversal Mercator Koordinaten:
      OSGB36  13


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.