IDatasourcesMgr3.UseDataExpanding (METH)ΒΆ

METHOD UseDataExpanding : SysTypes.RTS_IEC_RESULT

Activates the item of the given instance path for monitoring similar to IDatasourcesMgr.UseData. The difference of this method to IDatasourcesMgr.UseData 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.

Note

The items are reference counted so each call to IDatasourcesMgr.UseData or IDatasourcesMgr3.UseDataExpanding requires a matching call to IDatasourcesMgr.ReleaseData

InOut:

Scope

Name

Type

Comment

Return

UseDataExpanding

SysTypes.RTS_IEC_RESULT

Returns a runtime system error code (see CmpErrors.library) or one of Errors

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.