Prototype and description of the function getlicensee()

(This function needs no unlocking)


Determination of the GeoDLL licensee designation.

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

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

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

The function returns the designation of the licensee, like it was entered
with the function setunlockcode() before, 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:
pszLicensee Designation of the licensee.
(ref)       Note: "ref pszLicensee" corresponds to "char**" in C. 120 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

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

The description of the licensee could look like this:
   Licensed for:
   MacroModia Ltd, London

This function needs no unlocking.