Prototyp und Beschreibung der Funktion getntvrefstatus()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Gitterdaten")

 

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

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllexport) 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 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.