GitHub    Download    Forum
Overview
Tutorial
C++ API
General interfaces
Data interfaces
UDomain
UStorage
UObject
UList
Get
GetLength
Insert
Remove
Set
UBitFlagSet
UBitFlagSetSingle
WDomain
WObject
IEventClient
Schema interfaces
Configuration interfaces
Structures
Error codes
C# API
DTDL
DADL
Setup

UList::Insert

Inserts a new item to the list.

Syntax

HRESULT Insert(
[out] UINT32* p_pulIndex,
[in] void* p_pValue
);

Parameter

p_pulIndex [out]
Type: UINT32*
Variable that receives the index of the new item.
Can be NULL.
p_pValue [in]
Type: void*
Data of the new item. The data has to be in the packed item form.

Return value

S_OK if the function succeeds.
E_OBJECT_ATTRIBUTEALREADYEXISTS if the list has the 'ck' option set (see DTDL definitions) and an item with the same ID is already in the list.

Remarks

An item index can change whenever a writing or loading operation on the list or the object containing this list is called.
© 2022 Mobiland AG