Prototype and description of the function getdisclaimer()

(This function needs no unlocking)

 

getdisclaimer()
Determination of the disclaimer reference for the use of GeoDLL.

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

Prototype of the DLL function in Visual Objects syntax:
_DLL function getdisclaimer(;
     pszADisclaimer ref psz);              // 4 Byte, char**, 1000 alloc.
as logic pascal:geodll32.getdisclaimer     // 4 Byte

The allocation of memory for "ref psz" / "char**" is necessary only if
setstringallocate(FALSE) is called before.


The function returns the disclaimer reference for the use of GeoDLL as
a psz to the calling program. The lines of the text are separated by
"return and line feed".


The parameters are passed and/or returned as follows:
pszDisclaimer  Disclaimer reference.
(ref)       Note: "ref pszDisclaimer" corresponds to "char**" in C. 1000
            bytes of memory for the zero terminated string must be
            allocated with dependence to the call of the function
            setstringallocate(). Please consider the notes in the
            description of the function setstringallocate().

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


The disclaimer reference looks like this:
   GeoDLL xx.xx
   Disclaimer:
   There is no claim that data included within GeoDLL, or the results of
   calculations performed with GeoDLL, or other guaranteed characteristics of
   GeoDLL, will be complete, accurate and correct under any circumstances and
   in any possible cases. Under no circumstances can damage or subsequent
   demage, or loss or lost profits, caused by the use of GeoDLL, or the
   inability to use GeoDLL, or incorrect, incomplete or inaccurate results
   of calculations performed with GeoDLL, result in a liability.


Unlocking
This function needs no unlocking.