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
IDatasourcesMgr.CreateItemList (METH) ¶ METHOD CreateItemList : IDataItemList Creates a new item list that can be used for reading/writing synchronously for example. Important Please remark that you have to release the returned object when it is no longer in use by calling IDatasourcesMgr.DeleteItemList InOut: Scope Name Type Comment Return CreateItemList IDataItemList Input udiInitialCapacity UDINT The initial capacity of this list (will be extended if it becomes larger)
IDatasourcesMgr.DeleteItemList (METH) ¶ METHOD DeleteItemList : SysTypes.RTS_IEC_RESULT Deletes an item list and the items managed therin that was previously created using IDatasourcesMgr.CreateItemList InOut: Scope Name Type Comment Return DeleteItemList SysTypes.RTS_IEC_RESULT An error code representing the result of the operation. In case of success, ERR_OK will be returned Input itemsList IDataItemList
IDatasourcesMgr.EndDataConfiguration (METH) ¶ METHOD EndDataConfiguration : SysTypes.RTS_IEC_RESULT Releases a previously taken lock by IDatasourcesMgr.BeginDataConfiguration InOut: Scope Name Type Comment Return EndDataConfiguration SysTypes.RTS_IEC_RESULT Returns a runtime system error code (see CmpErrors.library) or one of Errors
IDatasourcesMgr.GetDatasource (METH) ¶ METHOD GetDatasource : IDatasource Returns the datasource representing the given object’s name. InOut: Scope Name Type Comment Return GetDatasource IDatasource The datasource object or 0 in case there is none with the given name. Input name STRING The name of the datasource as configured in the according object’s name in the project
IDatasourcesMgr.GetItemInfo (METH) ¶ METHOD GetItemInfo : IDataItemBase InOut: Scope Name Type Return GetItemInfo IDataItemBase Input pstSymbol POINTER TO STRING
IDatasourcesMgr.ReadItemsSync (METH) ¶ METHOD ReadItemsSync : SysTypes.RTS_IEC_RESULT Reads the given list of items synchronously. Important Please remark that the operation might take quite some time in case many items are contained within the list. For this time, the call is blocking! InOut: Scope Name Type Comment Return ReadItemsSync SysTypes.RTS_IEC_RESULT Input items IDataItemList The list of items that have to be read
IDatasourcesMgr2.PersistantItemListCount (PROP) ¶ PROPERTY PersistantItemListCount : INT Returns the number of persistant item lists
IDatasourcesMgr2.RemoveNotificationClient (METH) ¶ METHOD RemoveNotificationClient : SysTypes.RTS_IEC_RESULT This method can be called to remove an object that was formerly registered using IDatasourcesMgr2.AddNotificationClient InOut: Scope Name Type Comment Return RemoveNotificationClient SysTypes.RTS_IEC_RESULT An error code that signals whether the removal was successful. Input client INotificationClient The notification client object to remove
IDatasourcesMgr2.Unlock (METH) ¶ METHOD Unlock : SysTypes.RTS_IEC_RESULT Releases a previously taken lock by IDatasourcesMgr2.Lock InOut: Scope Name Type Comment Return Unlock SysTypes.RTS_IEC_RESULT Returns a runtime system error code (see CmpErrors.library) or one of Errors