Prototype and description of the function getcoordstrstatus()

(Function of the unlock requiring group "Parameter determination")


Determining whether a Coordinate System is a strip system.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall getcoordstrstatus(
     unsigned short wCoordSys,
     unsigned long *lStatus);

Prototype of the DLL function in Visual Objects syntax:
_DLL function getcoordstrstatus(;
     wCoordSys as word,;                   // 2 Byte
     lStatus ref logic);                   // 4 Byte
as logic pascal:geodll32.getcoordstrstatus // 4 Byte

The function determines whether the Coordinate System passed in wCoordSys
is a meridian strip system (eg. UTM, Gauss-Kruger) and returns the status
in the variable lStatus.

The parameters are passed and/or returned as follows:
wCoordSys   Coordinate System, for which the status "Meridian Strip System"
            is to be determined. The available Coordinate Systems are
            specified in the list "Coordinate Reference Systems".

lStatus     Status "Meridian Strip System". The status is returned by
(ref)       reference.
TRUE        The Coordinate System is a Meridian Strip System.
FALSE       The Coordinate System is not a Meridian Strip System.

returnVal   In case of an error the function returns FALSE, otherwise TRUE.

This function is a component of the unlock requiring function group
"parameter determination". It is unlocked for unrestricted use together with
the other functions of the group by passing the unlock parameters, acquired
from the software distribution company, trough the function setunlockcode().
Without unlocking only a few function calls for test purposes (shareware
principle) are possible.