Overview | Module | Use | Devguide | Index

Methods' Summary | Methods' Details | Attributes' Summary | Attributes' Details

:: com :: sun :: star :: uno ::
interface XUnloadingPreference
  Base Hierarchy
      XInterface
       |
       +-XUnloadingPreference
Description Components can implement`XUnloadingPreference` in order to indicate how they should be treated when their hosting library is to be unloaded. When someone calls`rtl_unloadUnusedModules` then the unloading listeners are notified by calling previously registered callback functions. A listener is an entity that employs, registers, and unregisters the callback functions on its behalf. Upon notification (the callback function is being called) a listener may release references to UNO components. Thus, the loaded libraries can be unloaded, if no one else keeps any objects from the library alive. Before a listener releases references, it should ask for this interface. If the interface is not implemented, then the listener may release the object; otherwise, it calls`releaseOnNotification` . If the function returns false then the listener should keep the reference, otherwise it may release it.

Methods' Summary
releaseOnNotification | The return value determines if the object wants to stay alive in case of an unloading procedure.

Methods' Details
releaseOnNotification
boolean releaseOnNotification(); |  |
Description The return value determines if the object wants to stay alive in case of an unloading procedure. Returns false do not release references to this object,otherwise true

Top of Page

Copyright © 2003 Sun Microsystems, Inc.