--- a/epoc32/include/mmsvattachmentmanagersync.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/mmsvattachmentmanagersync.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,94 @@
-mmsvattachmentmanagersync.h
+// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __MMSVATTACHMENTMANAGERSYNC_H__
+#define __MMSVATTACHMENTMANAGERSYNC_H__
+
+#include <e32base.h>
+#include <msvstd.h>
+#include <cmsvattachment.h>
+
+class MMsvAttachmentManagerSync
+/**
+Defines the attachment management extensions interface.
+
+This class is a pure virtual interface class that defines the APIs to be used for
+by MTMs and implementors of MMsvAttachmentManager.
+
+This API extends the MMsvAttachmentManager with synchronous calls for deleting
+and creating attachments.
+
+@see CMsvAttachment
+@publishedAll
+@released
+*/
+ {
+public:
+ /**
+ Creates a new empty attachment file.
+
+ The caller is returned an open writable file handle to an empty attachment file in the message
+ store. The caller must pass in an uninitialised file handle. If the request is sucessful the file handle
+ is open and must close by the caller once the data has been written to it.
+
+ @param aFileName The filename to assign to the newly create attachment file.
+ @param aAttachmentFile An uninitialised file handle. This is opened and can be written to if the
+ request is successful. The ownership is transferred . The caller must close the file handle.
+ @param aAttachmentInfo The attachment info associated with the file.
+ If the routine does not leave, then ownership will be transferred to the
+ attachment manager. If the routine does leave then ownership will not have
+ been transfered and the caller is responsible for cleanup.
+ @leave KErrAccessDenied If attachment manager is in read-only mode.
+ */
+ virtual void CreateAttachmentL(const TDesC& aFileName, RFile& aAttachmentFile, CMsvAttachment* aAttachmentInfo) = 0;
+
+
+
+ /**
+ Renames the physical filename of an attachment.
+
+ @param aIndex The array index position of the attachment to be renamed.
+ @param aNewName The new name of the attachment.
+ @leave KErrAccessDenied If attachment manager is in read-only mode.
+ @leave KErrAlreadyExists If the supplied attachment filename already exists.
+ */
+ virtual void RenameAttachmentL(TInt aIndex, const TDesC& aNewName) = 0;
+
+
+ /**
+ Removes the attachment from the message entry.
+
+ This changes the array index values of all the attachments after the removed one.
+ Attachment files stored in the message store are deleted. Linked files and message entry
+ attachments are not deleted, this is left to the caller to do if required.
+
+ @param aParam The array index position of the attachment to be removed.
+ @leave KErrAccessDenied If attachment manager is in read-only mode.
+ */
+ virtual void RemoveAttachmentL(TInt aIndex) = 0;
+
+ /**
+ Modify existing attachment
+ @param aAttachmentInfo The attachment info associated with the file.
+ If the routine does not leave, then ownership will be transferred to the
+ attachment manager. If the routine does leave then ownership will not have
+ been transfered and the caller is responsible for cleanup.
+ @leave KErrAccessDenied If attachment manager is in read-only mode.
+ */
+ virtual void ModifyAttachmentInfoL(CMsvAttachment* aAttachmentInfo) = 0;
+
+ };
+
+#endif // __MMSVATTACHMENTMANAGERSYNC_H__