Prototyp und Beschreibung der Funktion convntvbin2gridexport()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Werkzeuge")

 

convntvbin2gridexport()
NTv2-Gitter aus binärer Quelldatei in neue binäre Zieldatei exportieren.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall convntvbin2gridexport(
     const char *pszFileSource,
     const char *pszFileTarget,
     unsigned short nGridSource);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function convntvbin2gridexport(;
     pszFileSource as psz,;                     // 4 Byte, char*
     pszFileTarget as psz,;                     // 4 Byte, char*
     nGridSource word);                         // 2 Byte
as logic pascal:geodll32.convntvbin2gridexport  // 4 Byte


Die Dateinamen der NTv2-Quelldatei und der neu zu generierenden NTv2-
Zieldatei dürfen jeweils einen Laufwerksbuchstaben und eine Verzeichniskette
enthalten.
Beispiel:
Quellddatei  "c:\programm_ntv2\BeTA2007.gsb"
Zieldatei    "c:\programm_ntv2\Export.gsb"
Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden!

Die Funktion exportiert das NTv2-Gitter mit der Nummer nGridSource einer
binären NTv2-Quelldatei in eine neue binäre NTv2-Zieldatei. Dabei wird der
Datei-Header der Quelldatei in die Zieldatei kopiert. Die Anzahl der Gitter
NUM_FILE wird darin auf "1" gesetzt und der Name des Elterngitters PARENT
wird auf "NONE" gesetzt. Hinter dem Datei-Header wird das exportierte Gitter
mit dem Gitter-Header und den Gitterdaten eingetragen.

Die Nummer nGridSource des zu exportierenden Gitter kann mit der Funktion
getBinGridHeader() ermittelt werden.

Die Dateinamen der NTv2-Quelldatei und der neu zu generierenden NTv2-
Zieldatei dürfen jeweils einen Laufwerksbuchstaben und eine Verzeichniskette
enthalten.
Beispiel:
Quellddatei  "c:\programm_ntv2\BeTA2007.gsb"
Zieldatei    "c:\programm_ntv2\Export.gsb"
Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden!


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
pszFileSource  Dateiname der als Quelle verwendeten NTv2-Binärdatei aus der
            ein NTv2-Gitter exportiert werden soll. Der Dateiname darf einen
            Laufwerksbuchstaben und eine Verzeichniskette enthalten. Der
            Dateiname sollte die Dateinamens erweiterung ".gsb" haben.

pszFileTarget  Dateiname der zu neu erzeugenden Zielddatei zur Aufnahme des
            exportierten NTv2-Gitters. Der Dateiname darf einen Laufwerks-
            buchstaben und eine Verzeichniskette enthalten. Der Dateiname
            sollte die Dateinamenserweiterung ".gsb" haben.

nGridSource  Nummer des aus der Quelldatei zu exportierenden NTv2-Gitters.

returnWert  Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE.


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"NTv2-Werkzeuge". 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 mit dieser Funktion keine Funktions-
aufrufe zu Testzwecken (Sharewareprinzip) möglich.