Inserts a newly created entity instance to the model.
Parameters
Parameters
Description
instanceToInsert
[in] A smart pointer to the entity instance to be inserted.
insertHandle
[in] A handle of the parent object where to insert the entity instance.
Returns
An identifier of the inserted entity instance.
Remarks
If the entity being inserted already belongs to another model or it has been already appended or inserted before, the method returns a NULL object identifier. If the specified database handle already exists in the model, the entity defined with this handle gets a new handle value and the inserted entity (specified with the pInstanceToInsert parameter) takes the passed handle value (the insertHandle parameter value).