Updatetaglist() - Native C - Siemens Simatic S7-1500 Function Manual

If there are problems with the maximum number of entries and not all tags are needed, two
filters can be used when refreshing the tag table.
Table 7- 134 UpdateTagList() - Native C++
Syntax
Parameters
Return values
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
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:
Every combination of the following four areas:
IO: Inputs and Outputs
M: Bit memory
CT: Counters and Timers
DB: Data Blocks
The default setting is IOMCTDB.
Example: IOM reads only the tags from the area Inputs / Outputs and Bit
memory.
•
bool in_IsHMIVisibleOnly:
If , only tags marked with "HMI Visible" are read. The default setting is
true
.
true
•
WCHAR* in_DataBlockFilterList:
A string that includes the name of all data blocks that are supposed to be
available in the tag table. The string must be in quotation marks.
Example: ""\"DB_1\", \"DB_2\" \"DB_3\"|\"DB_4\"\"DB_5\""
All characters within the quotation marks are interpreted as a DB name. If the
data block does not exist in the PLC program, it is not added to the tag table
memory. No error is triggered in the process.
For this list to be taken into consideration,
unequal to NULL and
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INSTANCE_NOT_RUNNING
SREC_NOT_ENOUGH_MEMORY
SREC_WARNING_ALREADY_EXISTS
SREC_WRONG_ARGUMENT
in_DataBlockFilterList
has to contain "DB".
in_TagListDetails
Condition
The function is successful.
The instance is not registered in Runtime
Manager.
The function does not return on time.
The process of the virtual controller is not
running.
More than 500000 entries are requested.
The tag table is current.
The syntax of
is invalid. The list has to be 3 characters
long; the first and last character have to
be a quotation mark.
User interfaces (API)
7.6 API IInstances
has to be
in_DataBlockFilterList
153