Prototyp und Beschreibung der Funktion getusercoordpar()

(Funktion der freischaltpflichtigen Gruppe "Benutzerdefinitionen")

getusercoordpar()
Ermittlung der Parameterbezeichnungen einer Projektionsmethode.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall getusercoordpar(
     unsigned short nProjNo,
     char **pszProjPar);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getusercoordpar(;
     nProjNo as word,;                     // 2 Byte
     pszProjPar ref psz);                  // 4 Byte, char**, 500 alloc.
as logic pascal:geodll32.getusercoordpar   // 4 Byte

Die Allokation von Speicher für "ref psz" / "char**" ist nur notwendig,
wenn zuvor setstringallocate(FALSE) aufgerufen worden ist.


Die Funktion gibt die zu der in nProjNo übergebenen Projektionsmethode
passenden Bezeichnungen der Projektionsparameter als formatierten Text im
Parameter pszProjPar zurück. Der Text wird in der zuvor mit der Funktion
setLanguage() gesetzten Sprache zurückgegeben.


Die Parameter werden folgendermaßen übergeben:
nProjNo   (Projektionsmethode)
          Bezeichnung der Projektionsmethode
 1          Transversale Mercator Projektion
 2          Transversales Mercator Meridianstreifensystem
 3          Lambert Conformal Conic Projektion (1 Standard Parallele)
 4          Lambert Conformal Conic Projektion (2 Standard Parallele)
 5          Oblique Conformal Conic Projektion (z.B. Tschechei)
 6          Oblique Mercator Projektion (z.B. Schweiz, Alaska)
 7          Oblique Stereographic Projektion (z.B. Niederlande)
 8          Quasi Stereographic Projektion (z.B. Polen)
 9          Cassini Soldner Projektion
10          Lambert Azimuthal Equal Area Projektion
11          Rechtwinklige Ausgabegeräte-Projektion
12          Equidistant Cylindrical Projektion
13          Bonne Pseudoconical Equal Area Projektion
14          Albers Equal Area Conic Projektion
15          Mercator Projektion (1 Standard Parallele)
16          American Polyconic Projektion
99          Geographische Projektion

pszProjPar  Die Bezeichnungen der Projektions-Parameter werden als
(ref)       formatierter Text per Referenz zurückgegeben.
            Achtung: "ref pszProjPar" entspricht "char**" in C. Es müssen
            500 Byte Speicher für den Null terminated string in Abhängigkeit
            vom Aufruf der Funktion setstringallocate() allokiert werden.
            Beachten Sie dazu die Hinweise in der Beschreibung der Funktion
            setstringallocate()".

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


Der zurückgegebene String sieht in Abhängigkeit von der gewählten
Projektionsmethode z.B. so aus:
   Breitengrad 1. Standard-Paral. [Grad]
   Breitengrad 2. Standard-Paral. [Grad]
   Längengrad des Gitterursprungs [Grad]
   Breitengrad des Gitterursprungs [Grad]
   Östliche Verschiebung [Meter]
   Nördliche Verschiebung [Meter]


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