Prototype and description of the function karttknum()

(Function of the unlock requiring group "Map calculations")

karttknum()
Determination of the topographic maps with smaller scales fitting to a
topographic map TK25.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall karttknum(
     unsigned short nTK25,
     unsigned short *nTK50,
     unsigned short *nTK100,
     unsigned short *nTK200);

Prototype of the DLL function in Visual Objects syntax:
_DLL function karttknum(;
     nTK25 as word,;                       // 2 Byte
     nTK50 ref word,;                      // 4 Byte
     nTK100 ref word,;                     // 4 Byte
     nTK200 ref word);                     // 4 Byte
as logic pascal:geodll32.karttknum         // 4 Byte


The function returns the numbers of the official topographic maps with
different scales of the Federal Republic of Germany, in whose surface the
TK25 passed as parameter is present. With the determination of the maps
the standard sheet cut is considered.

If there are maps with smaller scales, in whose surface the TK25 is
present, the numbers of the following official topographic maps are
returned:
TK50 - Topographic map on a scale 1:50.000.
  Notation: Lnnnn
TK100 - Topographic map on a scale 1:100.000.
  Notation: Cnnnn
TKÜ200 - Topographic general map on a scale 1:200.000.
  Notation: CCnnnn
Returned are the numbers nnnn of the respective topographic map. The
notation must be supplemented with the leading letter.


The parameters are passed and/or returned as follows:
nTK25         Number of the TK25.

nTK50         Number of the found TK50 by reference.
(ref)

nTK100        Number of the found TK100 by reference.
(ref)

nTK200        Number of the found TKÜ200 by reference.
(ref)

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


Unlocking:
This function is a component of the unlock requiring function group
"map calculations". 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.