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. |