Prototyp und Beschreibung der Funktion getdllversion()

(Nicht freischaltpflichtige Funktion)

getdllversion()
Ermittlung der aktuellen Versionsnummer der GeoDLL.

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

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getdllversion(;
     pszVersion ref psz);                  // 4 Byte, char**, 15 alloc.
as logic pascal:geodll32.getdllversion     // 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 aktuelle Versionsnummer der GeoDLL in Form eines
psz an das rufende Programm zurück.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
pszVersion  String mit der aktuellen Versionsnummer von GeoDLL.
(ref)       Achtung: "ref pszDllVers" entspricht "char**" in C. Es müssen
            15 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.


Freischaltung:
Die Funktion ist nicht freischaltpflichtig.