IDataItemListExpanding.CreateAndAddExpanding (METH)ΒΆ

METHOD CreateAndAddExpanding : SysTypes.RTS_IEC_RESULT

Creates a new item for monitoring and immediately adds it to the list similar to IDataItemList.CreateAndAdd. The difference of this method to IDataItemList.CreateAndAdd is that variables of non scalar datatypes (eg. structures or arrays) maybe expanded automatically so that all sub elements are monitored instead of the complete value if that is necessary for a specific type of connected datasource.

InOut:

Scope

Name

Type

Comment

Return

CreateAndAddExpanding

SysTypes.RTS_IEC_RESULT

An error code representing the result of the operation. In case of success, ERR_OK will be returned

Input

pstSymbol

POINTER TO STRING

The symbolic name of the variable to activate. Here the name of the variable on the local PLC/HMI is expected.