Prototyp und Beschreibung der Funktion settzgridfile()

(Funktion der freischaltpflichtigen Gruppe "Zeitzonenberechnungen")

 

settzgridfile()
Initialisieren einer Gitterdatei zum Berechnen von Zeitzonen aus Koordinaten.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
__declspec(dllexport) unsigned long __stdcall settzgridfile(
     char *pszFileGrid);

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


Die Funktion überprüft und initialisiert eine Gitterdatei, in der ein
geometrisches Gitter mit allen Zeitzonen der Welt enthalten ist. Das Gitter wird
von der Funktion gettznumbycoordfast() verwendet, wenn anhand von Koordinaten
eine Zeitzone ermittelt werden soll. Die Prüfung des Dateinamens und des
Dateiinhalts erfolgt direkt beim Funktionsaufruf und eventuelle Fehlermeldungen
werden direkt von der Funktion settzgridfile() initialisiert.

Sie können die von GeoDLL unterstützte Gitterdatei mit der Bezeichnung
GEODLLTZ.GRD direkt von der KilletSoft Internetseite herunterladen.
Siehe http://www.killetsoft.de/p_gdlfzb_d.htm

Der Dateipfad darf einen Laufwerkbuchstaben, eine Verzeichniskette und den
Dateinamen GEODLLTZ.GRD enthalten. Ein abweichender Dateiname führt zu einer
Fehlermeldung.
Beispiel: "c:\program\timezone\geodlltz.grd".
Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden!


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
pszFileGrid   Dateipfad einer Gitterdatei mit dem Zeitzonen-Gitter.
              Der Dateipfad darf einen Laufwerkbuchstaben, die Verzeichniskette
              und den Dateinamen GEODLLTZ.GRD enthalten.

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


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"Zeitzonenberechnungen". Sie wird zusammen mit den anderen Funktionen der
Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen Freischalt-
parameter per Aufruf der Funktion setunlockcode() zur uneingeschränkten Nutzung
frei geschaltet. Ohne die Freischaltung sind nur wenige Funktionsaufrufe zu
Testzwecken (Sharewareprinzip) möglich.