Prototyp und Beschreibung der Funktion setntvbinaryfile()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Gitterdaten")

 

setntvbinaryfile()
Initialisieren einer NTv2-Gitterdaten-Binärdatei für den Bezugssystemwechsel.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall setntvbinaryfile(
     char *pszFileBinary);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function setntvbinaryfile(;
     pszFileBinary AS PSZ);                 // 4 Byte, char*
as logic pascal:geodll32.setntvbinaryfile   // 4 Byte


Die Funktion überprüft und initialisiert eine NTv2-Gitterdaten-Binärdatei
in der Gitterdaten für NTv2-Bezugssystemwechsel enthalten sind. Die Gitterdaten
werden von den Funktionen coordtrans???() verwendet, wenn dort als
Bezugssysteme die Kennungen für NTv2-Bezugssystemwechsel eingetragen sind. Der
erforderliche Speicherplatz für NTv2-Bezugssystemwechsel wird unabhängig von
der tatsächlichen Durchführung der Bezugssystemwechsel allokiert. Die Prüfung
des Dateiinhalts erfolgt direkt beim Funktionsaufruf und eventuelle
Fehlermeldungen werden direkt von der Funktion setntvbinaryfile()
initialisiert.

Alternativ kann auch die Funktion setntvbinautofile() verwendet werden,
die den Dateinamen nur in einer Warteposition ablegt. Die Prüfung und die
Allokation von Speicherplatz erfolgt dabei erst mit dem ersten NTv2-
Bezugssystemwechsel.

Sie können die von GeoDLL unterstützten NTv2-Dateien direkt von der
KilletSoft Internetseite "http://www.killetsoft.de", Produkte TRANSDAT und
GeoDLL herunterladen oder dort die Verweise zu den Originalquellen
verwenden. Auf der Internetseite finden Sie auch eine ausführliche
Beschreibung des NTv2-Standards.

Der Dateiname darf einen Laufwerkbuchstaben, eine Verzeichniskette und
eine Dateinamenserweiterung enthalten. Die Dateinamenserweiterung für
NTv2-Binärdateien ist standardmäßig "gsb".
Beispiel: "c:\programm_ntv2daten\beta2007.gsb".
Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden!

Mit den Funktionen getntvbinaryfile() und setntvbinaryfile() kann eine
automatische Auswahl und Initialisierung der erforderlichen NTv2-Datei
realisiert werden. Dazu müssen sich die benötigten NTv2-Dateien in einem
gemeinsamen Verzeichnis befinden. Beim Wechsel zu einem NTv2-gestützten
Bezugssystem wird mit der Funktion getntvbinaryfile() der Name der
erforderlichen NTv2-Datei ermittelt. Wenn die Datei im gemeinsamen Verzeichnis
vorhanden ist, wird sie dort mit der Funktion setntvbinaryfile()
initialisiert.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
pszFileBinary Dateiname einer NTv2-Binärdatei.
              Der Dateiname darf einen Laufwerkbuchstaben, die
              Verzeichniskette und die Dateinamenserweiterung enthalten.

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.