Prototyp und Beschreibung der Funktion getlicensee()

(Nicht freischaltpflichtige Funktion)

 

getlicensee()
Ermittlung des Lizenznehmers von GeoDLL.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall getlicensee(
     char **pszLicensee);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getlicensee(;
     pszLicensee ref psz);                 // 4 Byte, char**, 120 alloc.
as logic pascal:geodll32.getlicensee       // 4 Byte

Die Allokation von Speicher für "ref psz" / "char**" ist nur notwendig,
wenn zuvor setstringallocate(FALSE) aufgerufen worden ist.


Die Funktion gibt die Bezeichnung des Lizenznehmers, wie sie zuvor mit der
Funktion setunlockcode() eingegeben worden ist, in Form eines psz an das
rufende Programm zurück. Die Zeilen des Textes sind mit "Return und
LineFeed" voneinander getrennt.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
pszLicensee Bezeichnung des Lizenznehmers.
(ref)       Achtung: "ref pszLicensee" entspricht "char**" in C. Es müssen
            120 Byte Speicher für den Null terminated string in
            Abhängigkeit vom Aufruf der Funktion setstringallocate()
            allokiert werden. Beachten Sie dazu die Hinweise im Kapitel
            "Prototyp und Beschreibung der Funktion setstringallocate()".

returnWert  Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE.


Die Lizenznehmerbezeichnung könnte etwa so aussehen:
   Lizenziert für:
   MacroModia GmbH, München


Freischaltung:
Die Funktion ist nicht freischaltpflichtig.