Prototyp und Beschreibung der Funktion getntvgridcount()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Werkzeuge")

getntvgridcount()
Ermittlung der Anzahl der Gitter in einer NTv2-Datei.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall getntvgridcount(
     const char *pszFileNtv,
     unsigned long lAscii,
     unsigned short *ngridCount);

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


Die Funktion gibt die Anzahl der in einer ASCII- oder binär formatierten
NTv2-Datei enthaltenen Gitter zurück.


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

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

nGridCount  Die Anzahl der in der NTv2-Datei enthaltenen Gitter. Die
            Anzahl der Gitter wird per Referenz zurückgegeben.

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.