MKI_ExtDataAddEntity (Entity Creation) New in Version 2018.0

C++ Syntax

MKI_ENTITY_PTR

MKI_ExtDataAddEntity(

 MKI_ENTITY_PTR f_pEntity );

This procedure adds a copy of the given entity to the extended data list of a currently open provisional extended object (see MKI_ExtOpen or MKI_ExtDataOpen).

Parameters

f_pEntity

[MKI_ENTITY_PTR] Address of the entity to be copied to the extended data list. This can be either an already existing entity (e.g. in another object's list) or a new entity created by calling MKI_EntityBuffer, 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 entity if it was successfully inserted. Returns nullptr if the insertion was not successful, normally due to insufficient memory.