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!): extern "C" __declspec(dllimport) unsigned long __stdcall settzgridfile( const 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 Laufwerksbuchstaben, 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 Laufwerksbuchstaben, 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. |