Prototyp und Beschreibung der Funktion getntvrefbelong()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Gitterdaten")

 

getntvrefbelong()
Ermittlung des zweiten, zu einer NTv2-Datei gehörenden Bezugssystems.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllexport) 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 Gitterdaten". 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. Es ist zu beachten, dass zusätzlich
die Funktionsgruppe "Koordinatentransformationen" frei geschaltet sein muss.