IORRGetSystemInfo (Funktion)
- Last UpdatedSep 24, 2024
- 2 minute read
Die Funktion IORRGetSystemInfo() gibt Informationen zur Variablenzahl des Projekts zurück. Je nach übergebenem Parameter wird einer der folgenden Zahlenwerte zurückgegeben:
-
Maximale Anzahl von Fernverweisen, die nach der Lizenz zulässig ist.
-
Anzahl der Fernverweis-Adressen, die während der bisherigen Laufzeitsitzung im Rahmen der Lizenzierung gezählt wurden.
-
Anzahl der Fernverweise, die derzeit im Projekt aktiviert sind.
-
Anzahl der verfügbaren Fernverweise im ausgeführten InTouch-Projekt.
-
Anzahl der Fernverweise, die momentan deaktiviert sind.
-
Anzahl der lokalen Variablen im ausgeführten InTouch-Projekt.
-
-1, wenn ein Fehler auftritt oder ein ungültiger Wert für das Argument Option übergeben wird
Kategorie
Verschiedenes
Syntax
IORRGetSystemInfo(Option);
Argument
Option
Integer-Variable oder -Wert, der festlegt, welche Angabe zurückgegeben werden soll. Die möglichen Werte sind:
|
1 |
Gibt an, wie viele Fernverweis-Adressen die aktuell verwendete Lizenz maximal zulässt. Lokale E/A-Variablen sind in dieser Angabe nicht enthalten. Diese Angabe bleibt während der gesamten Laufzeitsitzung konstant. |
|
2 |
Gibt an, wie viele Fernverweis-Adressen während der Laufzeitsitzung bisher aktiviert und im Rahmen der Lizenzierung gezählt wurden. Lokale E/A-Variablen sind in dieser Angabe nicht enthalten. Wenn die Lizenz mehr als 60.000 Fernverweise unterstützt, wird unabhängig von der Anzahl der tatsächlich aktivierten Fernverweise eventuell der Wert 0 zurückgegeben. Bei einer unbeschränkten Lizenz zählt WindowViewer nicht, wie viele Fernverweis-Adressen aktiviert werden. Bei einer Lizenz mit einer eingeschränkten Anzahl von Fernverweis-Adressen steigt diese Angabe, bis sie die festgelegte Maximalzahl erreicht. Anschließend können keine weiteren Fernverweis-Adressen aktiviert werden. Es können lediglich Adressen, die bereits aktiviert sind, reaktiviert werden. Um die Anzahl der aktuell aktiven Fernverweis-Adressen zu erhalten, verwenden Sie Option = 3. |
|
3 |
Gibt die Anzahl der Fernverweis-Adressen zurück, die momentan im Projekt aktiviert sind. |
|
4 |
Gibt an, wie viele Fernverweis-Adressen noch im Projekt aktiviert werden können, bis keine Variablen-Handles mehr für Fernverweise verfügbar sind. Diese Anzahl ändert sich in der Regel während der Laufzeitsitzung, wenn Skripte mit Fernverweisen ausgeführt oder Fenster mit Fernverweisen geöffnet bzw. geschlossen werden. Diese Anzahl kann niedriger sein als die gemäß der Lizenz zulässige Anzahl (besonders bei einer unbeschränkten Lizenz), weil die Anzahl der Fernverweise, die gleichzeitig aktiv sein können, durch eine technische Obergrenze beschränkt wird. |
|
5 |
Gibt die Anzahl der Fernverweise zurück, die momentan im Projekt nicht aktiviert sind. |
|
6 |
Gibt die Anzahl der lokalen Variablen zurück, die im Projekt definiert sind. |
Beispiel
Im folgenden Beispiel wird die Anzahl der Fernverweisvariablen zurückgegeben, die für das Lizenzlimit gezählt werden, während eine InTouch-Anwendung ausgeführt wird. Die zurückgegebene Anzahl von Fernverweisvariablen wird als Wert der Integer-Variablen RRTagCount zugewiesen.
AnzahlFV = IORRGetSystemInfo(2);