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