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. |