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 &)

voidAttachmentFilePathL(TMsvIdaEntryId,
TDes &aFilePath
)[pure virtual]

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

Parameters

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

BodyTextFilePathL(TMsvId, TDes &)

voidBodyTextFilePathL(TMsvIdaMessageId,
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(TMsvIdaEntryId,
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 aEntryIdThe entry for which an attachment needs to be created in the message store
TDes & aFilenameThe name of the attachment file to be created
RFile & aFileOn return, The created file handle for the attachment file.The ownership is transferred . The caller must close the file handle.

CreatePlainTextFileL(RFile &, TMsvId)

voidCreatePlainTextFileL(RFile &aFile,
TMsvIdaBodyTextId
)[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 & aFileOn return, The opened file hanlde to the store . The ownership is transferred . The caller must close the file handle.
TMsvId aBodyTextIdThe Id of the bodytext.

CreateShareProtectedAttachmentForWriteL(TMsvId, TDes &, RFile &)

TBool CreateShareProtectedAttachmentForWriteL(TMsvIdaEntryId,
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 aEntryIdThe entry for which an attachment needs to be created in the message store
TDes & aFilenameThe name of the attachment file to be created
RFile & aFileOn 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(TMsvIdaEntryId,
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.

KErrNone if successful, otherwise any of the system wide error codes.

Parameters

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

DeleteFileStoreL(TMsvId)

voidDeleteFileStoreL(TMsvIdaEntryId)[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 aEntryIdThe entry whose store needs to be deleted

DeletePlainTextFileL(TMsvId)

voidDeletePlainTextFileL(TMsvIdaBodyTextId)[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 aBodyTextIdThe 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.

ETrue if file exists, otherwise EFalse.

Parameters

const TDesC & aFilePathThe full path specification of the file.

FileStoreExistsL(TMsvId)

TBool FileStoreExistsL(TMsvIdaEntryId)const [pure virtual]

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

ETrue if the store exists else EFalse

Parameters

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

OpenAttachmentForWriteL(TMsvId, const TDesC &, RFile &)

voidOpenAttachmentForWriteL(TMsvIdaEntryId,
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 aEntryIdThe entry whose attachment needs to be opened/read from the message store
const TDesC & aFilePathThe name and path of the attachment file to be opened
RFile & aFileOn 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 &)

voidOpenAttachmentL(TMsvIdaEntryId,
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 aEntryIdThe entry whose attachment needs to be opened/read from the message store
const TDesC & aFilePathThe name and path of the attachment file to be opened
RFile & aFileOn 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 &)

voidOpenBodyTextFileForReadL(RFile &aFile,
TMsvIdaBodyTextId,
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 & aFileOn return, The opened file hanlde to the store . The ownership is transferred . The caller must close the file handle.
TMsvId aBodyTextIdThe Id of the bodytext.
const TDesC & aFilePath

OpenFileStoreForRead(TMsvId, RFile &)

TInt OpenFileStoreForRead(TMsvIdaEntryId,
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 aEntryIdThe entry whose store needs to be opened/read
RFile & aFileOn return, The opened file hanlde to the store . The ownership is transferred . The caller must close the file handle.

OpenTempStoreFileL(TMsvId, RFile &)

voidOpenTempStoreFileL(TMsvIdaEntryId,
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 aEntryIdThe entry whose store needs to be opened/read
RFile & aFileOn 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(TMsvIdaEntryId,
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.

KErrNone if successful, otherwise any of the system wide error codes.

Parameters

TMsvId aEntryIdThe entry whose attachment needs to be renamed from the message store
const TDesC & aOldFilePathThe name and path of the attachment file to be renamed.
const TDesC & aNewNameThe new name of the attachment file.

ReplaceAttachmentForWriteL(TMsvId, TDes &, RFile &)

voidReplaceAttachmentForWriteL(TMsvIdaEntryId,
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 aEntryIdThe entry for which an attachment needs to be created in the message store
TDes & aFilenameThe name of the attachment file to be created
RFile & aFileOn return, The created file handle for the attachment file.The ownership is transferred . The caller must close the file handle.

ReplaceFileStoreL(TMsvId)

voidReplaceFileStoreL(TMsvIdaEntryId)[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 aEntryIdThe entry whose store needs to be replaced/overwritten

ReplacePlainTextFileL(TMsvId)

voidReplacePlainTextFileL(TMsvIdaBodyTextId)[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 aBodyTextIdThe Id of the bodytext.