function create a new object in the configuration database. Objects may contain other sub-objects or
keys with values.
On success the handle of the new object is returned in
This value should be used to refer to the object in future, eg when retrieving sub-keys or if the
object is destroyed.
is the handle of the object that is the parent of the new object. This can be
if the new object is to be a child of the top-level object.
Object names are not required to be unique in the database. If you call
twice with the same parameters you will create two different objects with the same name
but distinct object handles. You can iterate through similarly name objects using the
This call returns the CONFDB_OK value if successful, otherwise an error is returned.