Prototyp und Beschreibung der Funktion getntvheader()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Gitterdaten")

 

getntvheader()
Ermittlung der Header-Parameter einer NTv2-Datei.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
__declspec(dllimport) unsigned long __stdcall getntvheader(
     char *pszFileNtv,
     unsigned long lAscii,
     char **pszNtvHeader);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getntvheader;
     (pszFileNtv as psz,;                  // 4 Byte, char*
     lAscii as logic,;                     // 4 Byte
     pszgridHeader ref psz);               // 4 Byte, char**, 600 alloc.
as logic pascal:geodll32.getntvheader

Die Allokation von Speicher für "ref psz" / "char**" ist nur notwendig,
wenn zuvor setstringallocate(FALSE) aufgerufen worden ist.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
pszFileNtv  Dateiname der ASCII- oder binär formatierten NTv2-Datei, für
            die die NTv2-Header-Parameter ermittelt werden sollen.
            Der Dateiname darf einen Laufwerkbuchstaben, eine
            Verzeichniskette und eine Dateinamenserweiterung enthalten.

lAscii      TRUE: Die NTv2-Datei ist ASCII-formatiert.
            FALSE: Die NTv2-Datei ist binär formatiert.

pszNtvHeader  Header-Parameter der NTv2-Datei.
(ref)       Achtung: "ref pszNtvHeader" entspricht "char**" in C. Es
            müssen 600 Byte Speicher für den Null terminated string in
            Abhängigkeit vom Aufruf der Funktion setstringallocate()
            allokiert werden. Beachten Sie dazu die Hinweise im Kapitel
            "Prototyp und Beschreibung der Funktion setstringallocate()".

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


Der zurückgegebene Text sieht je nach den übergebenen geodätischen Systemen
z.B. so aus:
  Header der NTv2-Datei beta2007.gsb
  Anzahl der Datei-Header Records:  11
  Anzahl der Subgitter-Header Records:  11
  Anzahl der Subgitter:  1
  Einheit der Shiftwerte:  SECONDS
  Versionsbezeichnung:  NTv2.0
  Name des Quell-Bezugssystems:  DHDN90
  Name des Ziel-Bezugssystems:  ETRS89
  Großer Halbmesser des Quell-Ellipsoids [Meter]:  6377397.155
  Kleiner Halbmesser des Quell-Ellipsoids [Meter]:  6356078.963
  Großer Halbmesser des Ziel-Ellipsoids [Meter]:  6378137.000
  Kleiner Halbmesser des Ziel-Ellipsoids [Meter]:  6356752.314


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.