Prototyp und Beschreibung der Funktion closentvbinaryfile()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Transformationen")

closentvbinaryfile()
Schließt die NTv2-Gitterdaten-Binärdatei und gibt die NTv2-Instanz frei.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall closentvbinaryfile(
     void);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function closentvbinaryfile();
as logic pascal:geodll32.closentvbinaryfile  // 4 Byte


Die Funktion schließt eine aus vorherigen Funktionsaufrufen geöffnete NTv2-
Gitterdaten-Binärdatei und gibt die dazugehörende NTv2-Instanz frei.

Mit dem Aufruf der Funktionen setntvbinaryfile(), setntvbinautofile() und
setntvbinautodir() wird in GeoDLL eine NTv2-Instanz erzeugt, in der bei der
ersten NTv2-gestützten Koordinatentransformation eine NTv2-Gitterdaten-
Binärdatei geöffnet wird. Die NTv2-Instanz bleibt aktiv und die damit
verbundene NTv2-Datei bleibt geöffnet, bis eines der folgenden Ereignisse
eintritt:
1. Das die GeoDLL nutzende Programm wird geschlossen.
2. Das die GeoDLL nutzende Programm gibt die GeoDLL frei.
3. Eine neue NTv2-Instanz wird mit den oben genannten Funktionen erzeugt.
4. Die Funktion closentvbinaryfile() wird aufgerufen.

Daraus folgt, dass die Funktion closentvbinaryfile() nur dann aufgerufen werden
muss, wenn alle NTv2-gestützten Koordinatentransformationen beendet sind und der
externe Zugriff auf die NTv2-Binärdatei während des weiteren Programmlaufs
möglich sein soll.


Die Parameter werden folgendermaßen übergeben bzw. 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.