destroy
void destroy()
The destroy operation causes the object to cease to exist. If
the object is a Container, destroy is applied to all its
contents. If the object contains an IDLType attribute for an
anonymous type, that IDLType is destroyed. If the object is
currently contained in some other object, it is removed. If
destroy is invoked on a Repository or on a PrimitiveDef then
the BAD_INV_ORDER exception is raised with minor value 2.
Implementations may vary in their handling of references to an
object that is being destroyed, but the Repository should not
be left in an incoherent state. Attempt to destroy an object
that would leave the repository in an incoherent state shall
cause BAD_INV_ORDER exception to be raised with the minor code
1.