IDataItemList (ITF) ¶ INTERFACE IDataItemList EXTENDS __SYSTEM.IQueryInterface This interface represents a list of IDataItemBase that can be used for reading or writing synchronously for example Properties: Count Methods: Clear CreateAndAdd GetItem Structure: Clear (Method) Count (Property) CreateAndAdd (Method) GetItem (Method)

IDataItemList.Clear (METH) ¶ METHOD Clear : SysTypes.RTS_IEC_RESULT Clears the list of IDataItemBase managed by this list object. Allocated objects will be released. InOut: Scope Name Type Return Clear SysTypes.RTS_IEC_RESULT

IDataItemList.Count (PROP) ¶ PROPERTY Count : UDINT

IDataItemList.CreateAndAdd (METH) ¶ METHOD CreateAndAdd : SysTypes.RTS_IEC_RESULT Creates a new item for monitoring and immediately adds it to the list. Note Usually items are monitored in total. If you want to expand the items (to prevent problems with different alignment etc.) then consider using the method IDataItemListExpanding.CreateAndAddExpanding instead. InOut: Scope Name Type Comment Return CreateAndAdd 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.

IDataItemList.GetItem (METH) ¶ METHOD GetItem : IDataItemBase Returns the item at the given index. InOut: Scope Name Type Comment Return GetItem IDataItemBase The item at the index or 0 in case of an invalid index. Input udiIndex UDINT

IDataItemListExpanding (ITF) ¶ INTERFACE IDataItemListExpanding EXTENDS __SYSTEM.IQueryInterface As an extension to IDataItemList implementations of this interface are able to expand variables of non scalar datatypes (eg. structures or arrays) automatically so that all sub elements are monitored instead of the complete value if that is necessary for a specific type of connected datasource. Methods: CreateAndAddExpanding Structure: CreateAndAddExpanding (Method)

IDatasourcesMgr.ActionRecordingGetResult (METH) ¶ METHOD ActionRecordingGetResult : SysTypes.RTS_IEC_RESULT InOut: Scope Name Type Return ActionRecordingGetResult SysTypes.RTS_IEC_RESULT Output result IDatasourcesActionRecord

IDatasourcesMgr.ActionRecordingStart (METH) ¶ METHOD ActionRecordingStart : SysTypes.RTS_IEC_RESULT InOut: Scope Name Type Return ActionRecordingStart SysTypes.RTS_IEC_RESULT

IDatasourcesMgr.AllItemsOk (METH) ¶ METHOD AllItemsOk : SysTypes.RTS_IEC_RESULT This method will return ERR_OK when all active items of all datasources have the quality good else it will return ERR_DS_BADITEMS. It might return ERR_DS_MULTITASKING_LOCKED when it is currently not possible to have access to all datasources. In this case the client should call this method again later. InOut: Scope Name Type Return AllItemsOk SysTypes.RTS_IEC_RESULT

IDatasourcesMgr.BeginDataConfiguration (METH) ¶ METHOD BeginDataConfiguration : SysTypes.RTS_IEC_RESULT This method locks the concurrent task for monitoring items and allows subsequent accesses to the configuration of the active. To unlock again afterwards, call IDatasourcesMgr.EndDataConfiguration Important Before calling methods like IDatasourcesMgr.UseData or IDatasourcesMgr.ReleaseData it is necessary to do this syncronisation to prevent undefined behaviour. InOut: Scope Name Type Comment Return BeginDataConfiguration SysTypes.RTS_IEC_RESULT Returns a runtime system error code (see CmpErrors.library) or one of Errors Input xBlocking BOOL This variable signals the way to do the synchronization. TRUE: the call will be blocking FALSE: the call will be nonblocking and might faile with the error code Errors.ERR_DS_MULTITASKING_LOCKED