(PHP 4, PHP 5 < 5.2.0, PECL hwapi SVN)
hw_api->remove — Borra un objeto
Elimina un objeto del padre especificado. Las colecciones se eliminarán recursivamente.
Se puede pasar una consulta de objeto opcional para eliminar aquellos objetos que coincidan con la consulta. Un objeto se borrará físicamente si es la última instancia.
El array de parámetros contiene los elementos 'objectidentifier' y 'parentidentifier' requeridos. Si quiere eliminar un usuario o un grupo se puede saltar 'parentidentifier'.
El parámetro opcional 'mode' determina cómo se realiza la eliminación. En el modo "normal" el objeto no será eliminado fisicamente hasta que todas las instancias estén eliminadas. En el modo "physical" todas las instancias del objeto serán eliminadas inmediatamente. En el modo "removelinks" todas las referencias al y desde el objeto serán también eliminadas. En el modo "nonrecursive" la eliminación no se realiza recursivamenteo. Eliminar una colección que no está vacía causará un error.
Devuelve TRUE en caso de éxito o FALSE en caso de error.