C++ Syntax

MKI_ENTITY_OBJECT_PTR

MKI_ObjectAddContainer(

MKI_ENTITY_OBJECT_PTR f_pRefObj,

MKI_ENTITY_OBJECT_PTR f_pNewObj );

This procedure adds a container object to the link list of a given object.

Parameters

RefObj

[MKI_ENTITY_OBJECT_PTR] Address of the object to whose link-list the container object shall be copied.

NewObj

[MKI_ENTITY_OBJECT_PTR] Address of the container object to be copied to the extended data list. This can be either an already existing container (e.g. in another object's list) or a new container created by calling MKI_ContainerBuffer, adding all required data blocks using MKI_BLOCK_ENUM methods, and finally terminating it using MKI_BLOCK_ENUM::TerminateAndSetSize!

Return Value

Returns the address of the new container object if it was successfully inserted. Returns nullptr if the insertion was not successful, normally due to insufficient memory.