Prototyp und Beschreibung der Funktion karttknum()

(Funktion der freischaltpflichtigen Gruppe "Kartenberechnungen")

karttknum()
Ermittlung der zu einer Topographischen Karte TK25 passenden Karten
kleinerer Maßstäbe.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall karttknum(
     unsigned short nTK25,
     unsigned short *nTK50,
     unsigned short *nTK100,
     unsigned short *nTK200);

Prototyp der DLL-Funktion 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


Die Funktion gibt die Nummern der amtlichen topographischen Karten
verschiedener Maßstäbe der Bundesrepublik Deutschland zurück, in deren
Fläche die als Parameter übergebene TK25 liegt. Bei der Ermittlung der
Karten wird der Standardblattschnitt berücksichtigt.

Sofern es Karten mit kleineren Maßstäben gibt, in deren Fläche die TK25
liegt, werden die Nummern der folgenden amtlichen topographischen Karten
ermittelt:
TK50 - Topographische Karte im Maßstab 1:50000.
  Schreibweise: Lnnnn
TK100 - Topographische Karte im Maßstab 1:100000.
  Schreibweise: Cnnnn
TKÜ200 - Topographische Übersichtskarte im Maßstab 1:200000.
  Schreibweise: CCnnnn
Zurückgegeben werden die Nummern nnnn der jeweiligen topographischen Karten.
Die Schreibweise muss mit dem führenden Buchstaben ergänzt werden.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
nTK25         Nummer der TK25.

nTK50         Nummer der gefundenen TK50 per Referenz.
(ref)

nTK100        Nummer der gefundenen TK100 per Referenz.
(ref)

nTK200        Nummer der gefundenen TKÜ200 per Referenz.
(ref)

returnWert    Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE.


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"Kartenberechnungen". Sie wird zusammen mit den anderen Funktionen
der Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen
Freischaltparameter per Aufruf der Funktion setunlockcode() zur
uneingeschränkten Nutzung frei geschaltet. Ohne die Freischaltung sind nur
wenige Funktionsaufrufe zu Testzwecken (Sharewareprinzip) möglich.