The
confdb_object_create
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
object_handle.
This value should be used to refer to the object in future, eg when retrieving sub-keys or if the
object is destroyed.
parent_object_handle
is the handle of the object that is the parent of the new object. This can be
OBJECT_PARENT_HANDLE
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
confdb_object_create
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
confdb_object_find
call.
RETURN VALUE
This call returns the CONFDB_OK value if successful, otherwise an error is returned.