Prototype and description of the function geterrorcode()

(This function needs no unlocking)

 

geterrorcode()
Determination of the last error that occurs in functions of GeoDLL.

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

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

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


The function returns a description of the last error that occurs in
functions of the GeoDLL as a psz to the calling program. If with the
function setcoordarea() the range validation of the coordinates is switched
on, the function geterrorcode() is also referring to syntax and range
injuries.


The parameters are passed and/or returned as follows:
pszError    Description of the last error that occurs.
(ref)       Note: "ref pszError" corresponds to "char**" in C. 100 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 returned error description could look like this:
   Reference System Transition with pole near coordinates not possible


Unlocking
This function needs no unlocking.