Inhaltsverzeichnis
Werbung
PHB – P
-
ROGRAMMIER
4.4.12 getEnvStr, get Environment String
B
:
ESCHREIBUNG
B
D
:
ORLAND
ELPHI
C:
V
B
:
ISUAL
ASIC
R
:
ÜCKGABEWERT
A
:
NMERKUNGEN
D
B
:
ELPHI
EISPIEL
4.4.13 gettskinfo, Get Task Informations
B
:
ESCHREIBUNG
B
D
:
ORLAND
ELPHI
C:
V
B
:
ISUAL
ASIC
Parameter:
Rückgabewert:
A
:
NMERKUNG
R
UND
EFERENZHANDBUCH
Mit dieser Funktion wird die im String- bzw. Zeichen-Parameter spezifizierte
Umgebungsvariabel von der Steuerung ausgelesen und der Wert in den
aufrufenden Parameter eingetragen.
function getEnvStr (var EnvStr:CppString):integer;
int getEnvStr (char far * EnvStr);
Function getEnvStr (ByVal EnvStr As String) As Long
Die Funktion kann folgende Werte zurückliefern:
Rückgabe
wert
-1
0
> 0
Mit Hilfe dieser Funktion kann ein Applikationsprogramm das Vorhandensein von
Umgebungsvariablen prüfen, welche für die Anwendung von wichtiger Bedeutung
sind. Auf diese Weise kann eine Anwendung auch dann kontrolliert reagieren,
wenn z.B. durch einen Hardwaretausch wichtige Eigenschaften der Steuerung
nicht mehr vorhanden sind.
Das Beschreiben von Umgebungsvariablen ist nur bei ungebootetem System in
fwsetup möglich.
Diese Funktion existiert erst in RWMOS.ELF ab V2.5.3.37 und mcug3.dll ab
V2.5.3.25.
Der Datentyp CppString für Delphi ist in mcug3.pas versionsabhängig definiert.
EnvString : CppString;
.....
EnvString := allocmem (1024);
StrPCopy (EnvString, 'SerialNumber');
getEnvStr (EnvString);
Mit diesem Befehl kann eine Task abgefragt werden, ob ein noch nicht
ausgelesener String vorliegt.
function gettskinfo (TaskNr: integer; var tskinfo: integer): integer;
int gettskinfo (int TaskNr, int *tskinfo);
Function gettskinfo (ByVal tasknr As Long, tskinfo As Long) As Long
TaskNr: Tasknummer (0..3)
tskinfo: In dieser Variablen wird der Funktionswert zurückgeliefert
< 0: Kommando wird von RWMOS.ELF nicht unterstützt
= 0: Kommando erfolgreich ausgeführt
> 0: Zeitüberschreitung, Kommando nicht ausgeführt
Der Funktionswert wird in tskinfo zurückgeliefert. Bit 0 zeigt an, dass ein noch nicht
abgeschlossener String (write) vorliegt. Bit 1 zeigt an, dass ein abgeschlossener
String vorliegt (writeln). Die entsprechenden Bits werden durch das Auslesen des
String per gettskstr() automatisch zurückgesetzt.
Task Message Strings können in der Programmierumgebung der Stand-Alone-
Tasks per WRITE oder WRITELN erzeugt werden (Kapitel 6.6.79 und 6.6.80).
Fehler-Beschreibung
Fehler: z.B. RWMOS stellt die Funktion nicht zur
Verfügung.
Der Parameter wurde nicht gefunden oder ist ein leerer
String.
gibt die Stringlänge der gefundenen Zeichenkette an
33
Werbung
Inhaltsverzeichnis
