Prototyp und Beschreibung der Funktion getauthor()

(Nicht freischaltpflichtige Funktion)

 

getauthor()
Ermittlung des Urheberhinweises mit der Anschrift des Autors.

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

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

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


Die Funktion gibt den Urheberhinweis mit der Anschrift des Autors der
GeoDLL 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:
pszAuthor   Urheberhinweis mit der Anschrift des Autors.
(ref)       Achtung: "ref pszAuthor" entspricht "char**" in C. Es müssen
            200 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.


Der Urheberhinweis sieht so aus:
   GeoDLL xx.xx
   Urheberrecht seit 1996:
   Killet Software Ing.-GbR
   Escheln 28a
   47906 Kempen (Germany)


Freischaltung:
Die Funktion ist nicht freischaltpflichtig.