Prototype and description of the function getcoordproj()

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


Determination of the projection method number of a Coordinate System.

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

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

The function returns in the variable wProjNo the internal projection
method number of the Coordinate System passed by wCoordSys.

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

wProjNo     The projection method number is returned by reference.

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

Possible projection methods:
 1          Transverse Mercator Projection
 2          Transversal Mercator meridian strip system
 3          Lambert Conformal Conic Projection (1 standard parallel)
 4          Lambert Conformal Conic Projection (2 standard parallel)
 5          Oblique Conformal Conic Projection (e.g. Czech Republic)
 6          Oblique Mercator Projection (e.g. Switzerland, Alaska)
 7          Oblique Stereographic Projection (z.B. Netherlands)
 8          Quasi Stereographic Projection (e.g. Poland)
 9          Cassini Soldner Projection
10          Lambert Azimuthal Equal Area Projection
11          Orthogonal Output Device Projection
12          Equidistant Cylindrical Projection
13          Bonne Pseudoconical Equal Area Projection
14          Albers Equal Area Conic Projection
15          Mercator Projection (1 standard parallel)
16          American Polyconic Projection
99          Geographic Projection

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.