Prototyp und Beschreibung der Funktion getntvgridcount()

(Funktion der freischaltpflichtigen Gruppe "NTv2-Gitterdaten")

 

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

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
__declspec(dllimport) unsigned long __stdcall getntvgridcount(
     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 Subgitter 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 Subgitter ermittelt
            werden soll. 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.

ngridCount  Die Anzahl der in der NTv2-Datei enthaltenen Subgitter. Die
            Anzahl der Subgitter 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 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.