Siemens SIMATIC S7-1500 Funktionshandbuch Seite 173

Anwenderschnittstellen (API)
7.6 API IInstances
Wenn es Probleme mit der maximalen Anzahl der Einträge gibt, aber nicht alle Variablen
benötigt werden, dann können beim Aktualisieren der Variablentabelle zwei Filter genutzt
werden.
Tabelle 7- 155 UpdateTagList() - Native C++
Syntax
Parameter
172
ERuntimeErrorCode UpdateTagList();
ERuntimeErrorCode UpdateTagList(
ETagListDetails in_TagListDetails
);
ERuntimeErrorCode UpdateTagList(
ETagListDetails in_TagListDetails,
bool in_IsHMIVisibleOnly
);
ERuntimeErrorCode UpdateTagList(
ETagListDetails in_TagListDetails,
bool in_IsHMIVisibleOnly,
WCHAR* in_DataBlockFilterList
);
•
ETagListDetails in_TagListDetails:
Jede Kombination der folgenden vier Bereiche:
IO: Eingänge und Ausgänge
M: Merker
CT: Zähler und Zeiten
DB: Datenbausteine
Die Voreinstellung ist IOMCTDB.
Beispiel: IOM liest nur die Variablen aus der Area Eingänge / Ausgänge und
Merker.
•
bool in_IsHMIVisibleOnly:
Wenn true, werden nur Variablen gelesen, die mit "HMI Visible" markiert sind.
Die Voreinstellung ist true.
•
WCHAR* in_DataBlockFilterList:
Ein String, der die Namen aller Datenbausteine enthält, die im Variablentabel-
len-Speicher verfügbar sein sollen. Der String muss in Anführungszeichen ste-
hen.
Beispiel: ""\"DB_1\", \"DB_2\" \"DB_3\"|\"DB_4\"\"DB_5\""
Alle Zeichen innerhalb der Anführungszeichen werden als DB-Name interpre-
tiert. Wenn der Datenbaustein im PLC-Programm nicht existiert, wird er dem Va-
riablentabellen-Speicher nicht hinzugefügt, dabei wird kein Fehler ausgelöst.
Damit diese Liste berücksichtigt wird, muss in_DataBlockFilterList un-
gleich NULL sein und in_TagListDetails muss "DB" enthalten.
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD