fix toolbar import
[ooovba.git] / package / source / xstor / owriteablestream.hxx
blob5f10f7572e9d129565ed3155eedf916be3f96daf
1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * Copyright 2008 by Sun Microsystems, Inc.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * $RCSfile: owriteablestream.hxx,v $
10 * $Revision: 1.16 $
12 * This file is part of OpenOffice.org.
14 * OpenOffice.org is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License version 3
16 * only, as published by the Free Software Foundation.
18 * OpenOffice.org is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License version 3 for more details
22 * (a copy is included in the LICENSE file that accompanied this code).
24 * You should have received a copy of the GNU Lesser General Public License
25 * version 3 along with OpenOffice.org. If not, see
26 * <http://www.openoffice.org/license.html>
27 * for a copy of the LGPLv3 License.
29 ************************************************************************/
31 #ifndef _WRITESTREAM_HXX_
32 #define _WRITESTREAM_HXX_
34 #include <com/sun/star/io/XInputStream.hpp>
35 #include <com/sun/star/io/XOutputStream.hpp>
36 #include <com/sun/star/io/XStream.hpp>
37 #include <com/sun/star/io/XInputStream.hpp>
38 #include <com/sun/star/io/XSeekable.hpp>
39 #include <com/sun/star/io/XTruncate.hpp>
40 #include <com/sun/star/packages/XDataSinkEncrSupport.hpp>
41 #include <com/sun/star/packages/NoEncryptionException.hpp>
42 #include <com/sun/star/lang/XEventListener.hpp>
43 #include <com/sun/star/lang/XSingleServiceFactory.hpp>
44 #include <com/sun/star/lang/XComponent.hpp>
45 #include <com/sun/star/embed/XEncryptionProtectedSource.hpp>
46 #include <com/sun/star/embed/XStorage.hpp>
47 #include <com/sun/star/embed/XRelationshipAccess.hpp>
48 #include <com/sun/star/embed/XExtendedStorageStream.hpp>
49 #include <com/sun/star/embed/XTransactedObject.hpp>
50 #include <com/sun/star/embed/XTransactionBroadcaster.hpp>
51 #include <com/sun/star/container/XNameContainer.hpp>
52 #include <com/sun/star/beans/StringPair.hpp>
55 #include <cppuhelper/implbase1.hxx>
56 #include <cppuhelper/weak.hxx>
57 #include <cppuhelper/interfacecontainer.h>
59 #include <list>
61 #include "ocompinstream.hxx"
62 #include "mutexholder.hxx"
65 struct PreCreationStruct
67 SotMutexHolderRef m_rMutexRef;
69 PreCreationStruct()
70 : m_rMutexRef( new SotMutexHolder )
75 namespace cppu {
76 class OTypeCollection;
79 struct WSInternalData_Impl
81 SotMutexHolderRef m_rSharedMutexRef;
82 ::cppu::OTypeCollection* m_pTypeCollection;
83 ::cppu::OMultiTypeInterfaceContainerHelper m_aListenersContainer; // list of listeners
84 sal_Int16 m_nStorageType;
86 // the mutex reference MUST NOT be empty
87 WSInternalData_Impl( const SotMutexHolderRef rMutexRef, sal_Int16 nStorageType )
88 : m_rSharedMutexRef( rMutexRef )
89 , m_pTypeCollection( NULL )
90 , m_aListenersContainer( rMutexRef->GetMutex() )
91 , m_nStorageType( nStorageType )
95 typedef ::std::list< OInputCompStream* > InputStreamsList_Impl;
97 struct OStorage_Impl;
98 class OWriteStream;
100 struct OWriteStream_Impl : public PreCreationStruct
102 friend struct OStorage_Impl;
103 friend class OWriteStream;
104 friend class OInputCompStream;
106 OWriteStream* m_pAntiImpl;
107 ::rtl::OUString m_aTempURL;
109 InputStreamsList_Impl m_aInputStreamsList;
111 sal_Bool m_bHasDataToFlush; // only modified elements will be sent to the original content
112 sal_Bool m_bFlushed; // sending the streams is coordinated by the root storage of the package
114 ::com::sun::star::uno::Reference< ::com::sun::star::packages::XDataSinkEncrSupport > m_xPackageStream;
116 ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory > m_xFactory;
118 OStorage_Impl* m_pParent;
120 ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > m_aProps;
122 sal_Bool m_bForceEncrypted;
124 sal_Bool m_bUseCommonPass;
125 sal_Bool m_bHasCachedPassword;
126 ::rtl::OUString m_aPass;
128 ::com::sun::star::uno::Reference< ::com::sun::star::lang::XSingleServiceFactory > m_xPackage;
130 sal_Bool m_bHasInsertedStreamOptimization;
132 sal_Int16 m_nStorageType;
134 // Relations info related data, stored in *.rels file in OFOPXML format
135 ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > m_xOrigRelInfoStream;
136 ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair > > m_aOrigRelInfo;
137 sal_Bool m_bOrigRelInfoBroken;
139 ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair > > m_aNewRelInfo;
140 ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > m_xNewRelInfoStream;
141 sal_Int16 m_nRelInfoStatus;
142 sal_Int32 m_nRelId;
145 private:
146 ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory > GetServiceFactory();
148 ::rtl::OUString GetFilledTempFile();
149 ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream > GetTempFileAsStream();
150 ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > GetTempFileAsInputStream();
152 void CopyTempFileToOutput( ::com::sun::star::uno::Reference< ::com::sun::star::io::XOutputStream > xOutStream );
154 ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream > GetStream_Impl( sal_Int32 nStreamMode,
155 sal_Bool bHierarchyAccess );
157 ::rtl::OUString GetCommonRootPass() throw ( ::com::sun::star::packages::NoEncryptionException );
159 ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > ReadPackageStreamProperties();
160 ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > InsertOwnProps(
161 const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& aProps,
162 sal_Bool bUseCommonPass );
164 public:
165 OWriteStream_Impl(
166 OStorage_Impl* pParent,
167 const ::com::sun::star::uno::Reference< ::com::sun::star::packages::XDataSinkEncrSupport >& xPackageStream,
168 const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XSingleServiceFactory >& xPackage,
169 const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& xFactory,
170 sal_Bool bForceEncrypted,
171 sal_Int16 nStorageType,
172 const ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream >& xRelInfoStream =
173 ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream >() );
175 ~OWriteStream_Impl();
177 sal_Bool UsesCommonPass_Impl() { return m_bUseCommonPass; }
178 sal_Bool HasTempFile_Impl() { return ( m_aTempURL.getLength() != 0 ); }
179 sal_Bool IsTransacted();
181 sal_Bool HasWriteOwner_Impl() { return ( m_pAntiImpl != NULL ); }
183 void InsertIntoPackageFolder(
184 const ::rtl::OUString& aName,
185 const ::com::sun::star::uno::Reference< ::com::sun::star::container::XNameContainer >& xParentPackageFolder );
187 void SetToBeCommited() { m_bFlushed = sal_True; }
189 sal_Bool HasCachedPassword() { return m_bHasCachedPassword; }
190 ::rtl::OUString GetCachedPassword() { return m_aPass; }
191 sal_Bool IsModified() { return m_bHasDataToFlush || m_bFlushed; }
193 sal_Bool IsEncrypted();
194 void SetDecrypted();
195 void SetEncryptedWithPass( const ::rtl::OUString& aPass );
197 void DisposeWrappers();
199 void InsertStreamDirectly(
200 const ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream >& xInStream,
201 const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& aProps );
203 void Commit();
204 void Revert();
206 void Free( sal_Bool bMust ); // allows to try to disconnect from the temporary stream
207 // in case bMust is set to sal_True the method
208 // will throw exception in case the file is still busy
210 void SetModified(); // can be done only by parent storage after renaming
212 ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue > GetStreamProperties();
214 ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair > > GetAllRelationshipsIfAny();
216 void CopyInternallyTo_Impl( const ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& xDestStream,
217 const ::rtl::OUString& aPass );
218 void CopyInternallyTo_Impl( const ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& xDestStream );
220 ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream > GetStream(
221 sal_Int32 nStreamMode,
222 const ::rtl::OUString& aPass,
223 sal_Bool bHierarchyAccess );
225 ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream > GetStream(
226 sal_Int32 nStreamMode,
227 sal_Bool bHierarchyAccess );
230 ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > GetRawInStream();
231 ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > GetPlainRawInStream();
233 void InputStreamDisposed( OInputCompStream* pStream );
235 void CreateReadonlyCopyBasedOnData(
236 const ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream >& xDataToCopy,
237 const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& aProps,
238 sal_Bool bUseCommonPass,
239 ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& xTargetStream );
241 void GetCopyOfLastCommit( ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& xTargetStream );
242 void GetCopyOfLastCommit(
243 ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& xTargetStream,
244 const ::rtl::OUString& aPass );
247 void CommitStreamRelInfo(
248 const ::com::sun::star::uno::Reference< ::com::sun::star::embed::XStorage >& xRelStorage,
249 const ::rtl::OUString& aOrigStreamName,
250 const ::rtl::OUString& aNewStreamName );
252 void ReadRelInfoIfNecessary();
254 sal_Int32 GetNewRelId() { return m_nRelId ++; }
257 class OWriteStream : ::com::sun::star::lang::XTypeProvider
258 , public ::com::sun::star::io::XInputStream
259 , public ::com::sun::star::io::XOutputStream
260 , public ::com::sun::star::embed::XExtendedStorageStream
261 , public ::com::sun::star::io::XSeekable
262 , public ::com::sun::star::io::XTruncate
263 , public ::com::sun::star::embed::XEncryptionProtectedSource
264 , public ::com::sun::star::embed::XRelationshipAccess
265 , public ::com::sun::star::embed::XTransactedObject
266 , public ::com::sun::star::embed::XTransactionBroadcaster
267 , public ::com::sun::star::beans::XPropertySet
268 , public ::cppu::OWeakObject
270 friend struct OWriteStream_Impl;
272 protected:
273 ::com::sun::star::uno::Reference < ::com::sun::star::io::XInputStream > m_xInStream;
274 ::com::sun::star::uno::Reference < ::com::sun::star::io::XOutputStream > m_xOutStream;
275 ::com::sun::star::uno::Reference < ::com::sun::star::io::XSeekable > m_xSeekable;
277 OWriteStream_Impl* m_pImpl;
278 WSInternalData_Impl* m_pData;
280 sal_Bool m_bInStreamDisconnected;
281 sal_Bool m_bInitOnDemand;
283 sal_Bool m_bTransacted;
285 OWriteStream( OWriteStream_Impl* pImpl, sal_Bool bTransacted );
286 OWriteStream( OWriteStream_Impl* pImpl, ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream > xStream, sal_Bool bTransacted );
288 void CloseOutput_Impl();
290 void CopyToStreamInternally_Impl( const ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& xStream );
292 void ModifyParentUnlockMutex_Impl( ::osl::ResettableMutexGuard& aGuard );
294 void BroadcastTransaction( sal_Int8 nMessage );
296 public:
298 virtual ~OWriteStream();
300 void CheckInitOnDemand();
302 // XInterface
303 virtual ::com::sun::star::uno::Any SAL_CALL queryInterface( const ::com::sun::star::uno::Type& rType )
304 throw( ::com::sun::star::uno::RuntimeException );
305 virtual void SAL_CALL acquire() throw();
306 virtual void SAL_CALL release() throw();
308 // XTypeProvider
309 virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > SAL_CALL getTypes()
310 throw( ::com::sun::star::uno::RuntimeException );
311 virtual ::com::sun::star::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId()
312 throw( ::com::sun::star::uno::RuntimeException );
314 // XInputStream
315 virtual sal_Int32 SAL_CALL readBytes( ::com::sun::star::uno::Sequence< sal_Int8 >& aData, sal_Int32 nBytesToRead )
316 throw(::com::sun::star::io::NotConnectedException, ::com::sun::star::io::BufferSizeExceededException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
317 virtual sal_Int32 SAL_CALL readSomeBytes( ::com::sun::star::uno::Sequence< sal_Int8 >& aData, sal_Int32 nMaxBytesToRead ) throw(::com::sun::star::io::NotConnectedException, ::com::sun::star::io::BufferSizeExceededException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
318 virtual void SAL_CALL skipBytes( sal_Int32 nBytesToSkip )
319 throw(::com::sun::star::io::NotConnectedException, ::com::sun::star::io::BufferSizeExceededException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
320 virtual sal_Int32 SAL_CALL available( )
321 throw(::com::sun::star::io::NotConnectedException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
322 virtual void SAL_CALL closeInput( )
323 throw(::com::sun::star::io::NotConnectedException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
325 // XOutputStream
326 virtual void SAL_CALL writeBytes( const ::com::sun::star::uno::Sequence< sal_Int8 >& aData ) throw (::com::sun::star::io::NotConnectedException, ::com::sun::star::io::BufferSizeExceededException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
327 virtual void SAL_CALL flush( ) throw (::com::sun::star::io::NotConnectedException, ::com::sun::star::io::BufferSizeExceededException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
328 virtual void SAL_CALL closeOutput( ) throw (::com::sun::star::io::NotConnectedException, ::com::sun::star::io::BufferSizeExceededException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
330 //XSeekable
331 virtual void SAL_CALL seek( sal_Int64 location ) throw (::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
332 virtual sal_Int64 SAL_CALL getPosition() throw (::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
333 virtual sal_Int64 SAL_CALL getLength() throw (::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
335 //XStream
336 virtual ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > SAL_CALL getInputStream( ) throw (::com::sun::star::uno::RuntimeException);
337 virtual ::com::sun::star::uno::Reference< ::com::sun::star::io::XOutputStream > SAL_CALL getOutputStream( ) throw (::com::sun::star::uno::RuntimeException);
339 // XTruncate
340 virtual void SAL_CALL truncate() throw (::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
342 //XComponent
343 virtual void SAL_CALL dispose() throw (::com::sun::star::uno::RuntimeException);
344 virtual void SAL_CALL addEventListener( const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XEventListener >& xListener ) throw (::com::sun::star::uno::RuntimeException);
345 virtual void SAL_CALL removeEventListener( const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XEventListener >& aListener ) throw (::com::sun::star::uno::RuntimeException);
347 //XEncryptionProtectedSource
348 virtual void SAL_CALL setEncryptionPassword( const ::rtl::OUString& aPass )
349 throw ( ::com::sun::star::uno::RuntimeException,
350 ::com::sun::star::io::IOException );
351 virtual void SAL_CALL removeEncryption()
352 throw ( ::com::sun::star::uno::RuntimeException,
353 ::com::sun::star::io::IOException );
355 //XRelationshipAccess
356 virtual ::sal_Bool SAL_CALL hasByID( const ::rtl::OUString& sID ) throw (::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
357 virtual ::rtl::OUString SAL_CALL getTargetByID( const ::rtl::OUString& sID ) throw (::com::sun::star::container::NoSuchElementException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
358 virtual ::rtl::OUString SAL_CALL getTypeByID( const ::rtl::OUString& sID ) throw (::com::sun::star::container::NoSuchElementException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
359 virtual ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair > SAL_CALL getRelationshipByID( const ::rtl::OUString& sID ) throw (::com::sun::star::container::NoSuchElementException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
360 virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair > > SAL_CALL getRelationshipsByType( const ::rtl::OUString& sType ) throw (::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
361 virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair > > SAL_CALL getAllRelationships( ) throw (::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
362 virtual void SAL_CALL insertRelationshipByID( const ::rtl::OUString& sID, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair >& aEntry, ::sal_Bool bReplace ) throw (::com::sun::star::container::ElementExistException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
363 virtual void SAL_CALL removeRelationshipByID( const ::rtl::OUString& sID ) throw (::com::sun::star::container::NoSuchElementException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
364 virtual void SAL_CALL insertRelationships( const ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Sequence< ::com::sun::star::beans::StringPair > >& aEntries, ::sal_Bool bReplace ) throw (::com::sun::star::container::ElementExistException, ::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
365 virtual void SAL_CALL clearRelationships( ) throw (::com::sun::star::io::IOException, ::com::sun::star::uno::RuntimeException);
367 //XPropertySet
368 virtual ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySetInfo > SAL_CALL getPropertySetInfo() throw ( ::com::sun::star::uno::RuntimeException );
369 virtual void SAL_CALL setPropertyValue( const ::rtl::OUString& aPropertyName, const ::com::sun::star::uno::Any& aValue ) throw ( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::beans::PropertyVetoException, ::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );
370 virtual ::com::sun::star::uno::Any SAL_CALL getPropertyValue( const ::rtl::OUString& PropertyName ) throw ( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );
371 virtual void SAL_CALL addPropertyChangeListener( const ::rtl::OUString& aPropertyName, const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener >& xListener ) throw ( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );
372 virtual void SAL_CALL removePropertyChangeListener( const ::rtl::OUString& aPropertyName, const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertyChangeListener >& aListener ) throw ( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );
373 virtual void SAL_CALL addVetoableChangeListener( const ::rtl::OUString& PropertyName, const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XVetoableChangeListener >& aListener ) throw ( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );
374 virtual void SAL_CALL removeVetoableChangeListener( const ::rtl::OUString& PropertyName, const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XVetoableChangeListener >& aListener ) throw ( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );
376 // XTransactedObject
377 virtual void SAL_CALL commit()
378 throw ( ::com::sun::star::io::IOException,
379 ::com::sun::star::embed::StorageWrappedTargetException,
380 ::com::sun::star::uno::RuntimeException );
381 virtual void SAL_CALL revert()
382 throw ( ::com::sun::star::io::IOException,
383 ::com::sun::star::embed::StorageWrappedTargetException,
384 ::com::sun::star::uno::RuntimeException );
386 // XTransactionBroadcaster
387 virtual void SAL_CALL addTransactionListener(
388 const ::com::sun::star::uno::Reference< ::com::sun::star::embed::XTransactionListener >& aListener )
389 throw ( ::com::sun::star::uno::RuntimeException );
390 virtual void SAL_CALL removeTransactionListener(
391 const ::com::sun::star::uno::Reference< ::com::sun::star::embed::XTransactionListener >& aListener )
392 throw ( ::com::sun::star::uno::RuntimeException );
396 #endif