INTEGRATION: CWS fwkbugfix02 (1.2.148); FILE MERGED

2004/03/31 14:31:57 mav 1.2.148.3: #116056# persistance handling
2004/03/25 10:49:25 mav 1.2.148.2: #116056# interfaces review
2004/03/22 10:14:36 mav 1.2.148.1: #115011# review idl files

1 files changed, 22 insertions, 25 deletions

diff --git a/offapi/com/sun/star/embed/XPersistanceHolder.idl b/offapi/com/sun/star/embed/XPersistanceHolder.idl
index 4cb64033ae19..39dc2fecdbf8 100644
--- a/offapi/com/sun/star/embed/XPersistanceHolder.idl
+++ b/offapi/com/sun/star/embed/XPersistanceHolder.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XPersistanceHolder.idl,v $
  *
- *  $Revision: 1.2 $
+ *  $Revision: 1.3 $
  *
- *  last change: $Author: kz $ $Date: 2003-09-11 10:26:58 $
+ *  last change: $Author: hr $ $Date: 2004-05-10 18:07:11 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -69,32 +69,21 @@
 #include <com/sun/star/io/IOException.idl>
 #endif
 
+#ifndef __com_sun_star_io_XStream_idl__
+#include <com/sun/star/io/XStream.idl>
+#endif
+
 //=============================================================================
 
  module com {  module sun {  module star {  module embed {
 
 //=============================================================================
-/** Allows to put an object in to "HandsOff" state.
+/** allows to disconnect an object from its persistence.
  */
 interface XPersistanceHolder: com::sun::star::uno::XInterface
 {
     //-------------------------------------------------------------------------
-    /** Allows to put the object in to "HandsOff" state and back.
-
-        <p> In the "HandsOff" state the object should free all persistent resources.
-        So the persistent representation of the object is unusable.
-        </p>
-
-        <p>
-        The object should remember the location of the persistent representation to be able
-        to reconnect. For this purpose a storage in addition to XStorage interface must
-        support XPersistanceHolder itself. So the object will have to close all streams,
-        and put all storages to "HandsOff" states.
-        </p>
-
-        @param bHandsOff
-            <TRUE/>  - put the object in "HandsOff" state.
-            <FALSE/> - leave "HandsOff" state.
+    /** disconnects the object from the persistance.
 
         @throws com::sun::star::io::IOException
             in case of io problems
@@ -102,18 +91,26 @@ interface XPersistanceHolder: com::sun::star::uno::XInterface
         @throws com::sun::star::uno::Exception
             in case of other problems
      */
-    void doHandsOff( [in] boolean bHandsOff )
+    void disconnectPersistence()
         raises( ::com::sun::star::io::IOException,
                 ::com::sun::star::uno::Exception );
 
     //-------------------------------------------------------------------------
-    /** Allows to detect if the object is in "HandsOff" state.
+    /** connects the object to a persistance.
+
+        @param xStream
+            a stream that specify the persistance
 
-        @return
-            <TRUE/>  - the object in "HandsOff" state.
-            <FALSE/> - otherwise.
+        @throws com::sun::star::io::IOException
+            in case of io problems
+
+        @throws com::sun::star::uno::Exception
+            in case of other problems
      */
-    boolean isHandsOff();
+    void connectPersistance(
+            [in] ::com::sun::star::io::XStream xStream )
+        raises( ::com::sun::star::io::IOException,
+                ::com::sun::star::uno::Exception );
 
 };