Prototyp und Beschreibung der Funktion settzshapefile() (Funktion der freischaltpflichtigen Gruppe "Zeitzonenberechnungen") |
settzshapefile() Initialisieren einer Shapedatei zum Berechnen von Zeitzonen aus Koordinaten. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall settzshapefile( const char *pszFileShape); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function settzshapefile(; pszFileShape as psz); // 4 Byte, char* as logic pascal:geodll32.settzshapefile // 4 Byte Die Funktion überprüft und initialisiert eine Shapedatei, in der die Geometrien aller Zeitzonen der Welt enthalten sind. Die Geometrien werden von der Funktion gettznumbycoordexact() 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 settzshapefile() initialisiert. Sie können die von GeoDLL unterstützte Shapedatei mit der Bezeichnung GEODLLTZ.SHP 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.SHP enthalten. Ein abweichender Dateiname führt zu einer Fehlermeldung. Beispiel: "c:\programm_shape\geodlltz.shp" Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden! Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: pszFileShape Dateipfad einer Shapedatei mit den Geometrien der Zeitzonen. Der Dateipfad darf einen Laufwerksbuchstaben, die Verzeichniskette und den Dateinamen GEODLLTZ.SHP 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. |