This function removes an object from the specified
parent. Collections will be removed recursively. You can pass
an optional object query to remove only those objects which
match the query. An object will be deleted physically if it is
the last instance. The parameter array contains the required
elements 'objectidentifier' and 'parentidentifier'. If you want
to remove a user or group 'parentidentifier' can be skiped. The
optional parameter 'mode' determines how the deletion is
performed. In normal mode the object will not be removed
physically until all instances are removed. In physical mode
all instances of the object will be deleted imediately. In
removelinks mode all references to and from the objects will be
deleted as well. In nonrecursive the deletion is not performed
recursive. Removing a collection which is not empty will cause
an error.
See also
hwapi_move()
.