TMsvEntry Class Reference

class TMsvEntry

Represents an entry in the Message Server index.

MTM implementations and message client applications use it to access and manipulate index entry values. Note that a TMsvEntry is effectively a local cache of the index entry, and changes to it are not automatically written into the index. To commit changes to the Message Server, you need to call CMsvEntry::ChangeL() (or CMsvServerEntry::ChangeEntry()).

To avoid repetition, the functions and data members are simply listed here, without detailed explanation of the fields. The public data members can be used to get and set the values of some index entry fields.

Public Member Functions
	TMsvEntry()
	TMsvEntry(const TMsvEntry &)
TBool	Attachment()
TBool	Complete()
TBool	Connected()
void	DecPcSyncCount()
TBool	DeleteProtected()
TBool	Deleted()
IMPORT_C void	ExternalizeL(RWriteStream &)
TBool	Failed()
TBool	Forwarded()
TMsvId	Id()
TBool	InPreparation()
void	IncPcSyncCount()
IMPORT_C void	InternalizeL(RReadStream &)
TBool	LocallyDeleted()
IMPORT_C TInt32	MtmData1()
IMPORT_C TInt32	MtmData2()
IMPORT_C TInt32	MtmData3()
TBool	MultipleRecipients()
TBool	New()
TBool	OffPeak()
TBool	Operation()
TBool	Owner()
TMsvId	Parent()
TInt	PcSyncCount()
IMPORT_C TBool	PendingConditions()
TBool	PendingDelete()
IMPORT_C TBool	PermanentDataUnchanged(const TMsvEntry &)
IMPORT_C TMsvPriority	Priority()
TBool	ReadOnly()
TBool	Scheduled()
TUint	SendingState()
void	SetAttachment(TBool)
void	SetComplete(TBool)
void	SetConnected(TBool)
void	SetDeleteProtected(TBool)
void	SetFailed(TBool)
void	SetForwarded(TBool)
void	SetInPreparation(TBool)
void	SetLocallyDeleted(TBool)
IMPORT_C void	SetMtmData1(TInt32)
IMPORT_C void	SetMtmData2(TInt32)
IMPORT_C void	SetMtmData3(TInt32)
void	SetMultipleRecipients(TBool)
void	SetNew(TBool)
void	SetOffPeak(TBool)
void	SetOperation(TBool)
IMPORT_C void	SetPendingConditions(TBool)
void	SetPendingDelete(TBool)
IMPORT_C void	SetPriority(TMsvPriority)
void	SetReadOnly(TBool)
void	SetScheduled(TBool)
void	SetSendingState(TUint)
void	SetStandardFolder(TBool)
void	SetUnread(TBool)
void	SetVisible(TBool)
void	SetVisibleFolderFlag(TBool)
TBool	StandardFolder()
TBool	Unread()
TBool	Visible()
TBool	VisibleFolderFlag()
IMPORT_C TMsvEntry &	operator=(const TMsvEntry &)
IMPORT_C TBool	operator==(const TMsvEntry &)

Protected Member Functions
TUint	PersistedFlags()
void	SetDeleted(TBool)
void	SetId(TMsvId)
void	SetOwner(TBool)
void	SetParent(TMsvId)
TUint	TemporaryFlags()

Private Member Functions
void	Copy(const TMsvEntry &)

Public Attributes
TInt32	iBioType
TTime	iDate
TPtrC	iDescription
TPtrC	iDetails
TInt32	iError
TUid	iMtm
TInt32	iMtmData1
TInt32	iMtmData2
TInt32	iMtmData3
TMsvId	iRelatedId
TMsvId	iServiceId
TInt32	iSize
TUid	iType

Private Attributes
TInt32	iData
TMsvId	iId
TMsvId	iParentId
TInt32	iPcSyncCount
TInt32	iReserved

Constructor & Destructor Documentation

TMsvEntry()

IMPORT_C

TMsvEntry

(

)

TMsvEntry(const TMsvEntry &)

IMPORT_C

TMsvEntry

(

const TMsvEntry &

aEntry

)

Parameters

const TMsvEntry & aEntry

Member Functions Documentation

Attachment()

TBool

Attachment

(

)

const [inline]

Gets the value of the attachment flag.

The value of the attachment flag

Complete()

TBool

Complete

(

)

const [inline]

Gets the value of the message complete flag.

Note that for email download without size limits, the complete flag will only be set to true once all the parts of the message (body text and attachments) have been downloaded.

The value of the message complete flag

Connected()

TBool

Connected

(

)

const [inline]

Gets the value of the remote server connection flag.

The value of the remote server connection flag

Copy(const TMsvEntry &)

void

Copy

(

const TMsvEntry &

aEntry

)

[private]

Parameters

const TMsvEntry & aEntry

DecPcSyncCount()

void

DecPcSyncCount

(

)

[inline]

Decrements the PC synchronisation field.

DeleteProtected()

TBool

DeleteProtected

(

)

const [inline]

Deleted()

TBool

Deleted

(

)

const [inline]

Gets the value of the deleted flag.

The value of the deleted flag

ExternalizeL(RWriteStream &)

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

const

Parameters

RWriteStream & aStream

Failed()

TBool

Failed

(

)

const [inline]

Gets the value of the message send failed flag.

The value of the message send failed flag

Forwarded()

TBool

Forwarded

(

)

const [inline]

Id()

TMsvId

(

)

const [inline]

Gets the value of the entry ID.

The value of the entry ID

InPreparation()

TBool

InPreparation

(

)

const [inline]

Gets the value of the in preparation flag.

The value of the in preparation flag

IncPcSyncCount()

void

IncPcSyncCount

(

)

[inline]

Increments the PC synchronisation field.

InternalizeL(RReadStream &)

IMPORT_C void

InternalizeL

(

RReadStream &

aStream

)

Parameters

RReadStream & aStream

LocallyDeleted()

TBool

LocallyDeleted

(

)

const [inline]

MtmData1()

IMPORT_C TInt32

MtmData1

(

)

const

MtmData2()

IMPORT_C TInt32

MtmData2

(

)

const

MtmData3()

IMPORT_C TInt32

MtmData3

(

)

const

MultipleRecipients()

TBool

MultipleRecipients

(

)

const [inline]

Gets the value of the multiple recipients flag.

The value of the multiple recipients flag

New()

TBool

New

(

)

const [inline]

Gets the value of the new message flag.

The value of the new message flag

OffPeak()

TBool

OffPeak

(

)

const [inline]

Gets the off-peak flag.

The value of the off-peak flag

Operation()

TBool

Operation

(

)

const [inline]

Gets the value of the disconnected operation queued flag.

The value of the disconnected operation queued flag

Owner()

TBool

Owner

(

)

const [inline]

Gets the value of the owner flag.

The value of the owner flag

Parent()

TMsvId

Parent

(

)

const [inline]

Gets the value of the parent ID.

The value of the parent ID

PcSyncCount()

TInt

PcSyncCount

(

)

const [inline]

Gets the value of the PC synchronisation field.

The value of the PC synchronisation field

PendingConditions()

IMPORT_C TBool

PendingConditions

(

)

const

PendingDelete()

TBool

PendingDelete

(

)

const [inline]

PermanentDataUnchanged(const TMsvEntry &)

IMPORT_C TBool

PermanentDataUnchanged

(

const TMsvEntry &

aEntry

)

const

Parameters

const TMsvEntry & aEntry

PersistedFlags()

TUint

PersistedFlags

(

)

const [protected, inline]

Priority()

IMPORT_C TMsvPriority

Priority

(

)

const

ReadOnly()

TBool

ReadOnly

(

)

const [inline]

Gets the value of the read-only flag.

The value of the read-only flag

Scheduled()

TBool

Scheduled

(

)

const [inline]

Gets the scheduled flag.

The value of the scheduled flag

SendingState()

TUint

SendingState

(

)

const [inline]

Gets the sending state.

The sending state

SetAttachment(TBool)

void

SetAttachment

(

TBool

aAttachmentFlag

)

[inline]

Sets the attachment flag.

Parameters

TBool aAttachmentFlag

Value for the attachment flag

SetComplete(TBool)

void

SetComplete

(

TBool

aComplete

)

[inline]

Sets the message complete flag.

Note that for email download without size limits, the complete flag will only be set to true once all the parts of the message (body text and attachments) have been downloaded.

Parameters

TBool aComplete

Value for the message complete flag

SetConnected(TBool)

void

SetConnected

(

TBool

aConnected

)

[inline]

Sets the remote server connection flag.

Parameters

TBool aConnected

Value for the remote server connection flag

SetDeleteProtected(TBool)

void

SetDeleteProtected

(

TBool

aDeleteProtected

)

[inline]

This method sets bit 24 of iMtmData1, if you are using this bit elsewhere don't call this method.

Parameters

TBool aDeleteProtected

SetDeleted(TBool)

void

SetDeleted

(

TBool

aDeletedFlag

)

[protected, inline]

Parameters

TBool aDeletedFlag

SetFailed(TBool)

void

SetFailed

(

TBool

aFailed

)

[inline]

Sets the message send failed flag.

Parameters

TBool aFailed

Value for the message send failed flag

SetForwarded(TBool)

void

SetForwarded

(

TBool

aForwarded

)

[inline]

This method sets bit 31 of iMtmData1, if you are using this bit elsewhere don't call this method.

Parameters

TBool aForwarded

SetId(TMsvId)

void

SetId

(

TMsvId

aId

)

[protected, inline]

Parameters

TMsvId aId

SetInPreparation(TBool)

void

SetInPreparation

(

TBool

aInPreparation

)

[inline]

Sets the in-preparation flag.

Parameters

TBool aInPreparation

Value for the in-preparation flag

SetLocallyDeleted(TBool)

void

SetLocallyDeleted

(

TBool

aLocallyDeleted

)

[inline]

This method sets bit 32 of iMtmData1, if you are using this bit elsewhere don't call this method.

Parameters

TBool aLocallyDeleted

SetMtmData1(TInt32)

IMPORT_C void

SetMtmData1

(

TInt32

aMtmData

)

Parameters

TInt32 aMtmData

SetMtmData2(TInt32)

IMPORT_C void

SetMtmData2

(

TInt32

aMtmData

)

Parameters

TInt32 aMtmData

SetMtmData3(TInt32)

IMPORT_C void

SetMtmData3

(

TInt32

aMtmData

)

Parameters

TInt32 aMtmData

SetMultipleRecipients(TBool)

void

SetMultipleRecipients

(

TBool

aMultipleRecipient

)

[inline]

Sets the multiple recipients flag.

Parameters

TBool aMultipleRecipient

Value for the multiple recipients flag

SetNew(TBool)

void

SetNew

(

TBool

aNew

)

[inline]

Sets the message new flag.

Parameters

TBool aNew

Value for the message new flag

SetOffPeak(TBool)

void

SetOffPeak

(

TBool

aOffPeak

)

[inline]

Sets the off-peak flag.

Parameters

TBool aOffPeak

Value for off-peak flag.

SetOperation(TBool)

void

SetOperation

(

TBool

aOperation

)

[inline]

Sets the disconnected operation queued flag.

Parameters

TBool aOperation

Value for the disconnected operation queued flag

SetOwner(TBool)

void

SetOwner

(

TBool

aAttachment

)

[protected, inline]

Parameters

TBool aAttachment

SetParent(TMsvId)

void

SetParent

(

TMsvId

aId

)

[protected, inline]

Parameters

TMsvId aId

SetPendingConditions(TBool)

IMPORT_C void

SetPendingConditions

(

TBool

aPendingConditions

)

Parameters

TBool aPendingConditions

SetPendingDelete(TBool)

void

SetPendingDelete

(

TBool

aPendingDelete

)

[inline]

Parameters

TBool aPendingDelete

SetPriority(TMsvPriority)

IMPORT_C void

SetPriority

(

TMsvPriority

aPriority

)

Parameters

TMsvPriority aPriority

SetReadOnly(TBool)

void

SetReadOnly

(

TBool

aReadOnly

)

[inline]

Sets the read-only flag.

Parameters

TBool aReadOnly

Value for the read-only flag

SetScheduled(TBool)

void

SetScheduled

(

TBool

aScheduled

)

[inline]

Sets the scheduled flag.

Parameters

TBool aScheduled

Value for the scheduled flag.

SetSendingState(TUint)

void

SetSendingState

(

TUint

aSendingState

)

[inline]

Sets the sending state.

Parameters

TUint aSendingState

The sending state. This must be a value between 0x00 and KMsvSendStateMax.

SetStandardFolder(TBool)

void

SetStandardFolder

(

TBool

aStanardFolder

)

[inline]

Parameters

TBool aStanardFolder

SetUnread(TBool)

void

SetUnread

(

TBool

aUnread

)

[inline]

Sets the message unread flag.

Parameters

TBool aUnread

Value for the message unread flag

SetVisible(TBool)

void

SetVisible

(

TBool

aVisble

)

[inline]

Sets the entry visible flag.

Parameters

TBool aVisble

Value for the entry visible flag

SetVisibleFolderFlag(TBool)

void

SetVisibleFolderFlag

(

TBool

aReadOnly

)

[inline]

Sets the flag for the TMsvEntry's visible folder(CMsvCacheVisibleFolder), if the entry is visible while creation.

Parameters

TBool aReadOnly

StandardFolder()

TBool

StandardFolder

(

)

const [inline]

Gets the value of the standard folder flag.

The value of the standard folder flag

TemporaryFlags()

TUint

TemporaryFlags

(

)

const [protected, inline]

Unread()

TBool

Unread

(

)

const [inline]

Gets the value of the message unread flag.

The value of the message unread flag

Visible()

TBool

Visible

(

)

const [inline]

Gets the value of the entry visible flag.

The value of the entry visible flag

VisibleFolderFlag()

TBool

VisibleFolderFlag

(

)

const [inline]

Gets the value of the TMsvEntry's visible folder flag. The value of the entry visible flag

operator=(const TMsvEntry &)

IMPORT_C TMsvEntry &

operator=

(

const TMsvEntry &

aEntry

)

Parameters

const TMsvEntry & aEntry

operator==(const TMsvEntry &)

IMPORT_C TBool

operator==

(

const TMsvEntry &

aEntry

)

const

Parameters

const TMsvEntry & aEntry

Member Data Documentation

TInt32 iBioType

TInt32

iBioType

BIO message type

TInt32 iData

TInt32

iData

[private]

TTime iDate

TTime

iDate

Time

TPtrC iDescription

TPtrC

iDescription

Description

TPtrC iDetails

TPtrC

iDetails

Details

TInt32 iError

TInt32

iError

Error

TMsvId iId

TMsvId

iId

[private]

TUid iMtm

TUid

iMtm

MTM

TInt32 iMtmData1

TInt32

iMtmData1

MTM data 1: this can be used for any purpose by an MTM. This member must only be accessed through the predefined set and get functions. If you must write data to a bit that has no meaning in the predefined derived classes then you must derive your own class from TMsvEntry.

TInt32 iMtmData2

TInt32

iMtmData2

MTM data 2: this can be used for any purpose by an MTM. This member must only be accessed through the predefined set and get functions. If you must write data to a bit that has no meaning in the predefined derived classes then you must derive your own class from TMsvEntry.

TInt32 iMtmData3

TInt32

iMtmData3

MTM data 3: this can be used for any purpose by an MTM. This member must only be accessed through the predefined set and get functions. If you must write data to a bit that has no meaning in the predefined derived classes then you must derive your own class from TMsvEntry.

TMsvId iParentId

TMsvId

iParentId

[private]

TInt32 iPcSyncCount

TInt32

iPcSyncCount

[private]

TMsvId iRelatedId

TMsvId

iRelatedId

Related folder ID.

TInt32 iReserved

TInt32

iReserved

[private]

TMsvId iServiceId

TMsvId

iServiceId

Service ID.

TInt32 iSize

TInt32

iSize

Size

TUid iType

TUid

iType

Entry type