Prototype and description of the function settzgridfile()

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


Initialises a gridfile 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 settzgridfile(
     const char *pszFileGrid);

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

The function tests and initializes a gridfile containing a geometric grid of
world-wide all time zones. The geometries are used by the function
gettznumbycoordfast() 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 settzgridfile().

You can download the GeoDLL supported gridfile namend GEODLLTZ.GRD directly
from the KilletSoft website.

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

The parameters are passed and/or returned as follows:
pszFileGrid   File path of a gridfile with a geometric grid of time zones. The
              file path may contain a drive letter, a directory path and the
              file name GEODLLTZ.GRD.

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

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.