Prototype and description of the function settzshapefile()

(Function of the unlock requiring group "Time Zone Calculations")

settzshapefile()
Initialises a shapefile for calculation of time zones from coordinates.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall settzshapefile(
     const char *pszFileShape);

Prototype of the DLL function in Visual Objects syntax:
_DLL function settzshapefile(;
     pszFileShape as psz);                  // 4 Byte, char*
as logic pascal:geodll32.settzshapefile     // 4 Byte


The function tests and initializes a shapefile containing the geometries of
world-wide all time zones. The geometries are used by the function
gettznumbycoordexact() to calculate time zones from coordinates. The testing of
the file name and the file content is made directly with the function call and
any error messages are directly initialized by the function settzshapefile().

You can download the GeoDLL supported shapefile namend GEODLLTZ.SHP directly
from the KilletSoft website.
See http://www.killetsoft.de/p_gdlfzb_e.htm.

The file path may contain a drive letter, a directory path and the file name
GEODLLTZ.SHP. An other file name  results in an error message.
Example: "c:\programm_shape\geodlltz.shp".
Attention, in C syntax double backslashes must be used!


The parameters are passed and/or returned as follows:
pszFileShape  File path of a shapefile with geometries of the time zones. The
              file path may contain a drive letter, a directory path and the
              file name GEODLLTZ.SHP.

returnVal     In case of an error the function returns FALSE, otherwise TRUE.


Unlocking:
This function is a component of the unlock requiring function group
"Time zone calculations". It is unlocked for unrestricted use together with the
other functions of the group by passing the unlock parameters, acquired
from the software distribution company, trough the function setunlockcode().
Without unlocking only a few function calls for test purposes (shareware
principle) are possible.