Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



TMsvEntry functions and members used in POP3 message entries

The table below describe the functions and member variables for TMsvEntry that are set by the POP3 MTM for a POP3 message:

Attachment()

Set to ETrue if the message contains one or more attachment files.

Complete()

All emails copied or moved into a local folder are always marked as complete because the POP3 MTM is only able to download a complete message from the remote server.

Email messages in the remote inbox are marked as incomplete by default, since no email body data has been downloaded into the message. In disconnected mode, a message will be marked complete if the user has requested the POP3 client to populate a message in the remote inbox.

Connected()

Not used by POP3 MTM.

Failed()

Not used by POP3 MTM.

iDate

The time and date the message was originally sent by the author.

If the message did not contain a date, or contained an illegal date, then iDate will be set to the current home time.

iDescription

The text from the subject line of the email message.

iDetails

The full email address of the sender (e.g. John Smith <[email protected]>)

iError

The error code which occurred while operations was being carried out on the message (normally KErrNone).

iMtm

Set to KUidMsgTypePOP3

iMtmData1

Reserved

iMtmData2

Reserved

iMtmData3

Reserved

InPreparation()

Set when a message is being created; reset when the creation of the message has been completed.

iRelatedId

Used to associate a ghost entry to a message entry.

Ghost entries are added by the POP3 MTM to indicate where messages will be placed after a pending off-line operation. They look identical to the entries of the message that they represent except that they have no store associated with them, they have their complete flag set to EFalse, and they have their related ID set to the ID source entry.

iServiceId

Identifies the POP3 service that created the message.

iSize

Size, in bytes, of the email message.

In the remote inbox, if Complete()==EFalse, the size represents the total size of the RFC822 message in the mailbox (i.e it represents the complete message in the mailbox).

For all POP3 messages, if Complete()==ETrue (in the remote inbox or in a local folder), then size represents the total size of the entire decoded message on the Symbian OS phone, which may be less than the size of the message when it was in the remote mailbox.

iType

Set to KUidMsvMessageEntry.

MultipleRecipients()

Not used by POP3 MTM.

New()

All emails copied or moved into a local folder are always marked as new (i.e. New()==ETrue). It is the clients responsibility to change this setting if the message is subsequently read by the user.

In the remote inbox, a message is marked as new if it did not exist in the mailbox in the last email session (i.e. it is a new email).

Operation()

Not used by POP3 MTM.

PcSyncCount()

Not used by POP3 MTM.

Priority()

Priority of the email message.

If no priority assigned by sending client, then priority set to EMsvNormalPriority.

ReadOnly()

Not used by POP3 MTM

StandardFolder()

Not used by POP3 MTM

Unread()

All emails copied or moved into a local folder are always marked as unread (i.e. Unread()==ETrue). It is the clients responsibility to change this setting if the message is subsequently read by the user.

In the remote inbox, a message is marked as unread if it did not exist in the mailbox in the last email session (i.e. it is a new email).

Visible()

Set to ETrue on all emails.