Prototyp und Beschreibung der Funktion getntvrefbelong() (Funktion der freischaltpflichtigen Gruppe "NTv2-Transformationen") |
getntvrefbelong() Ermittlung des zweiten, zu einer NTv2-Datei gehörenden Bezugssystems. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall getntvrefbelong( unsigned short wRefSys, unsigned short *wRefNtvB); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function getntvrefbelong(; wRefSys as word,; // 2 Byte wRefNtvB ref word); // 4 Byte as logic pascal:geodll32.getntvrefbelong // 4 Byte Die Funktion gibt für das NTv2-Bezugssystem wRefSys das zweite zur NTv2- Datei gehörende NTv2-Bezugssystem in wRefNtvB zurück. Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: wRefSys Zu einer NTv2-Gitterdatei gehörendes geodätisches Bezugssystem, für welches das zweite NTv2-Bezugssystem ermittelt werden soll. Die verfügbaren Bezugssysteme sind in der Liste "Koordinatenbezugssysteme" aufgeführt. wRefNtvE Nummer des ermittelten zweiten NTv2-Bezugssystems. Die (ref) Nummer des geodätischen Bezugssystems wird per Referenz zurückgegeben. returnWert Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE. Freischaltung: Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe "NTv2-Transformationen". Sie wird zusammen mit den anderen Funktionen der Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen Freischalt- parameter per Aufruf der Funktion setunlockcode() zur uneingeschränkten Nutzung frei geschaltet. Ohne die Freischaltung sind nur wenige Funktions- aufrufe zu Testzwecken (Sharewareprinzip) möglich. Es ist zu beachten, dass zusätzlich die Funktionsgruppe "Koordinatentransformationen" frei geschaltet sein muss. |