Prototyp und Beschreibung der Funktion getunitpar()

(Funktion der freischaltpflichtigen Gruppe " Parameterermittlung")

 

getunitpar()
Ermittlung der Umrechnungskontante einer Maßeinheit.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall getunitpar(
     unsigned short nUnit,
     double *nUnit2Meter);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getunitpar(;
     nUnit as word,;                       // 2 Byte
     nUnit2Meter ref real8);               // 8 Byte
as logic pascal:geodll32.getunitpar       // 4 Byte


Die Funktion gibt die Umrechnungskontante nach Meter der in nUnit übergebenen
Maßeinheit per Referenz im Parameter nUnit2Meter zurück.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
nUnit       Maßeinheit, für die die Umrechnungskontante ermittelt werden soll.
            Die verfügbaren Maßeinheiten sind in der Liste
            "Koordinatenbezugssysteme alphabetisch (unten)" aufgeführt.

nUnit2Meter Die Umrechnungskontante der Maßeinheit nach Meter wird per
(ref)       Referenz zurückgegeben.

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


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"Parameterermittlung". 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.