Prototyp und Beschreibung der Funktion getntvrefstatus()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Transformationen")

getntvrefstatus()
Feststellen ob ein Bezugssystem zu einer NTv2-Gitterdatei gehört.

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

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getntvrefstatus(;
     wRefSys as word,;                     // 2 Byte
     lStatus ref logic);                   // 4 Byte
as logic pascal:geodll32.getntvrefstatus   // 4 Byte


Die Funktion testet, ob das Bezugssystem wRefSys zu einer NTv2-
Gitterdatei gehört und gibt das Ergebnis in der logischen
Variablen lStatus zurück.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
wRefSys     Geodätisches Bezugssystem, das auf die Zugehörigkeit zu
            einer NTV2-Gitterdatei getestet werden soll. Die verfügbaren
            Bezugssysteme sind in der Liste "Koordinaten- und
            Bezugssysteme" aufgeführt.

lStatus     Status "NTv2-Bezugssystem". Der Status wird per Referenz
(ref)       zurückgegeben.
TRUE        Das Bezugssystem gehört zu einer NTv2-Gitterdatei.
FALSE       Das Bezugssystem gehört nicht zu einer NTv2-Gitterdatei.

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.