MMsvStoreManager Class Reference

class MMsvStoreManager

Provides the File Access mechanism to the files that are stored in the message server's data cage in a secure manner. Presents a common interface to message store file access regardless of the process that its running in. For instance, when the File Access APIs are used on the client-side process, the implementation uses secure IPC calls to the message server that includes capability policing, however, when the same API is used on the server-side, the implementation has direct access to the file in the message store.

Member Functions Documentation

AttachmentFilePathL(TMsvId, TDes &)

void AttachmentFilePathL ( TMsvId aEntryId,
TDes & aFilePath
) [pure virtual]

Queries the message server for the file path where attachments are stored for the a particular message entry.

Parameters

TMsvId aEntryId The message entry for which the attachment path is required.
TDes & aFilePath On return, this will be set to the file path where the attachment should be stored.

BodyTextFilePathL(TMsvId, TDes &)

void BodyTextFilePathL ( TMsvId aMessageId,
TDes & aFilepath
) [pure virtual]
Gets the path of the bodytext file related to a message in the message store for the message id passed to it.
leave
KErrAlreadyexists, if the file with the same name already existed the directory.

Parameters

TMsvId aMessageId
TDes & aFilepath

CreateAttachmentForWriteL(TMsvId, TDes &, RFile &)

TBool CreateAttachmentForWriteL ( TMsvId aEntryId,
TDes & aFilename,
RFile & aFile
) [pure virtual]

Allows clients to create a new empty file and allows clients to stream data to it.

Creates a new attachment file in the message store for the message entry specified by the aEntryId parameter. The attachment filename is set to the filename indicated by the aFilename parameter. The empty attachment file is passed back to the client using an opened file handle to the file in the message store.

leave
KErrAlreadyexists, if the file with the same name already existed the directory.

Parameters

TMsvId aEntryId The entry for which an attachment needs to be created in the message store
TDes & aFilename The name of the attachment file to be created
RFile & aFile On return, The created file handle for the attachment file.The ownership is transferred . The caller must close the file handle.

CreatePlainTextFileL(RFile &, TMsvId)

void CreatePlainTextFileL ( RFile & aFile,
TMsvId aBodyTextId
) [pure virtual]

Allows the message store classes to create the store file for a particular message entry.

Creates a message store file associated with the message entry specified by the aFilepath parameter. This method returns an open read-write file handle to the message store file.

leave
one of the other system-wide error codes.

Parameters

RFile & aFile On return, The opened file hanlde to the store . The ownership is transferred . The caller must close the file handle.
TMsvId aBodyTextId The Id of the bodytext.

CreateShareProtectedAttachmentForWriteL(TMsvId, TDes &, RFile &)

TBool CreateShareProtectedAttachmentForWriteL ( TMsvId aEntryId,
TDes & aFilename,
RFile & aFile
) [pure virtual]

Creates an Attachment using a ShareProtected RFs.Used in the case when a message contains a DRM attachment

leave
KErrAlreadyexists, if the file with the same name already existed the directory.

Parameters

TMsvId aEntryId The entry for which an attachment needs to be created in the message store
TDes & aFilename The name of the attachment file to be created
RFile & aFile On return, The created file handle for the attachment file.The ownership is transferred . The caller must close the file handle.

DeleteAttachment(TMsvId, const TDesC &)

TInt DeleteAttachment ( TMsvId aEntryId,
const TDesC & aFilePath
) [pure virtual]

Allow clients to delete existing attachment files.

Deletes an existing attachment file in the message store associated with the message entry specified by the aEntryId parameter. The attachment is identified by the file path specified by the aFilePath parameter.

Parameters

TMsvId aEntryId The entry whose attachment needs to be deleted from the message store
const TDesC & aFilePath The name and path of the attachment file to be deleted

DeleteFileStoreL(TMsvId)

void DeleteFileStoreL ( TMsvId aEntryId ) [pure virtual]

Deletes the store file associated with the message entry as specified by the aEntryId. Also attempts to delete the temporary store file if one exists.

Parameters

TMsvId aEntryId The entry whose store needs to be deleted

DeletePlainTextFileL(TMsvId)

void DeletePlainTextFileL ( TMsvId aBodyTextId ) [pure virtual]

Deletes the store file associated with the message entry as specified by aFilepath.

leave
KErrNotFound if file is not found else any of the system wide errors

Parameters

TMsvId aBodyTextId The Id of the bodytext.

FileExistsL(const TDesC &)

TBool FileExistsL ( const TDesC & aFilePath ) [pure virtual]

Check if an attachment file with the given path and name already exists.

Parameters

const TDesC & aFilePath The full path specification of the file.

FileStoreExistsL(TMsvId)

TBool FileStoreExistsL ( TMsvId aEntryId ) const [pure virtual]

Queries the message server to check if a store file exists for the message entry specified by the aEntryId parameter.

Parameters

TMsvId aEntryId The entry for whom the check for existance of store is being done

OpenAttachmentForWriteL(TMsvId, const TDesC &, RFile &)

void OpenAttachmentForWriteL ( TMsvId aEntryId,
const TDesC & aFilePath,
RFile & aFile
) [pure virtual]

Allows clients to open an attachment file for writing.

Opens an existing attachment file in the message associated with the message entry specified by the aEntryId parameter. The attachment is identified by the file path specified by the aFilePath parameter. The attachment file is returned as a read/write file handle to the file in the message store.

Parameters

TMsvId aEntryId The entry whose attachment needs to be opened/read from the message store
const TDesC & aFilePath The name and path of the attachment file to be opened
RFile & aFile On return, The opened file handle for the attachment file.The ownership is transferred . The caller must close the file handle.

OpenAttachmentL(TMsvId, const TDesC &, RFile &)

void OpenAttachmentL ( TMsvId aEntryId,
const TDesC & aFilePath,
RFile & aFile
) [pure virtual]

Allows clients to view attachment files.

Opens an existing attachment file in the message associated with the message entry specified by the aEntryId parameter. The attachment is identified by the file path specified by the aFilePath parameter. The attachment file is returned as a read-only file handle to the file in the message store.

Parameters

TMsvId aEntryId The entry whose attachment needs to be opened/read from the message store
const TDesC & aFilePath The name and path of the attachment file to be opened
RFile & aFile On return, The opened file handle for the attachment file.The ownership is transferred . The caller must close the file handle.

OpenBodyTextFileForReadL(RFile &, TMsvId, const TDesC &)

void OpenBodyTextFileForReadL ( RFile & aFile,
TMsvId aBodyTextId,
const TDesC & aFilePath
) [pure virtual]

Allows the message store classes to read the store file for a particular message entry.

Opens a message store file associated with the message entry specified by the aFilepath parameter. This method returns an open read-only file handle to the message store file.

leave
KErrNotFound if file is not found else any of the system wide errors

Parameters

RFile & aFile On return, The opened file hanlde to the store . The ownership is transferred . The caller must close the file handle.
TMsvId aBodyTextId The Id of the bodytext.
const TDesC & aFilePath

OpenFileStoreForRead(TMsvId, RFile &)

TInt OpenFileStoreForRead ( TMsvId aEntryId,
RFile & aFile
) [pure virtual]

Allows the message store classes to read the store file for a particular message entry.

Opens a message store file associated with the message entry specified by the aEntryId parameter. This method returns an open read-only file handle to the message store file.

leave
KErrNotFound if file is not found else any of the system wide errors

Parameters

TMsvId aEntryId The entry whose store needs to be opened/read
RFile & aFile On return, The opened file hanlde to the store . The ownership is transferred . The caller must close the file handle.

OpenTempStoreFileL(TMsvId, RFile &)

void OpenTempStoreFileL ( TMsvId aEntryId,
RFile & aFile
) [pure virtual]

Opens a temporary store file associated with the message entry specified by the aEntryId parameter. This method returns an open read-write file handle with an exclusive share to the temporary store file. The temporary store file is defined as <store_filename>.new. Data can be streamed to the temporary store file. It is expected that once the temporary store file has been written to and then closed, a call to ReplaceFileStoreL is required to replace the old store file with this temporary one.

Along with ReplaceFileStoreL, this method allows the message store classes to write data to the store file for a particular message entry.

Parameters

TMsvId aEntryId The entry whose store needs to be opened/read
RFile & aFile On return, The opened file hanlde to the store . The ownership is transferred . The caller must close the file handle.

RenameAttachment(TMsvId, const TDesC &, const TDesC &)

TInt RenameAttachment ( TMsvId aEntryId,
const TDesC & aOldFilePath,
const TDesC & aNewName
) [pure virtual]

Renames an existing attachment file.

Renames an existing attachment file in the message store associated with the message entry specified by the aEntryId parameter. The attachment is identified by the file path specified by the aOldFilePath parameter and renamed to the name supplied in the aNewName paramter.

Parameters

TMsvId aEntryId The entry whose attachment needs to be renamed from the message store
const TDesC & aOldFilePath The name and path of the attachment file to be renamed.
const TDesC & aNewName The new name of the attachment file.

ReplaceAttachmentForWriteL(TMsvId, TDes &, RFile &)

void ReplaceAttachmentForWriteL ( TMsvId aEntryId,
TDes & aFilename,
RFile & aFile
) [pure virtual]

Allows clients to replace an existing attachment file and allows clients to stream data to it.

Replaces an existing attachment file in the message store for the message entry specified by the aEntryId parameter. The attachment filename is set to the filename indicated by the aFilename parameter. If an attachment with the supplied name does not exist, a new file is created. The empty attachment file is passed back to the client using an opened file handle to the file in the message store.

Parameters

TMsvId aEntryId The entry for which an attachment needs to be created in the message store
TDes & aFilename The name of the attachment file to be created
RFile & aFile On return, The created file handle for the attachment file.The ownership is transferred . The caller must close the file handle.

ReplaceFileStoreL(TMsvId)

void ReplaceFileStoreL ( TMsvId aEntryId ) [pure virtual]

Replaces the current store file with the temporary store file, created from OpenTempStoreFileL, for the message entry as specified by the aEntryId parameter. The method replaces the store file with the temporary file (<store_filename.new>) and if successful, will then delete the temporary store file. This method assumes that the temporary file exists, otherwise a KErrNotFound error occurs.

Along with OpenTempStoreFileL, this method allows the message store classes to write data to the store file for a particular message entry.

Parameters

TMsvId aEntryId The entry whose store needs to be replaced/overwritten

ReplacePlainTextFileL(TMsvId)

void ReplacePlainTextFileL ( TMsvId aBodyTextId ) [pure virtual]
Replaces the bodytext file associated with the message specified by aEntryId.
leave
KErrNotFound if file is not found else any of the system wide errors

Parameters

TMsvId aBodyTextId The Id of the bodytext.