IDatasourcesMgr2.CreatePersistantItemList (METH)¶

METHOD CreatePersistantItemList : IDataItemListPersistant

Creates an item list that will be registered automatically within the affected datasources after (re)connections of these datasources. An according list can be used in followup calls to IDatasourcesMgr.ReadItemsSync or IDatasourcesMgr.WriteItemsSync

Important

Having such lists might slow down the connection setup because the list has to be registered within the connected device!

Important

Using this method and the related ones working on the list requires according locking around using IDatasourcesMgr2.Lock and IDatasourcesMgr2.Unlock

Note

It is not supported to register several lists for the same usecase.

Note

Once the list is no longer necessary, it can be deleted using IDatasourcesMgr2.DeletePersistantItemList

InOut:

Scope	Name	Type	Comment
Return	`CreatePersistantItemList`	IDataItemListPersistant
Input	`usage`	PersistantItemListUsage	The usecase this list is intended for
	`usageDetails`	`WSTRING`	Some details of the usage. In case of PersistantItemListUsage.Recipes this will be the name of the recipe definition.
	`udiInitialCapacity`	`UDINT`	The initial capacity of this list (will be extended if it becomes larger)
Output	`result`	`SysTypes.RTS_IEC_RESULT`	An error code providing additional information in case of creation problems