TMsvEntry functions and members used in SMTP message entries

TMsvEntry member

Description

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 SMTP 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 SMTP client to populate a message in the remote inbox.

Connected()

Normally set to EFalse.

This flag is set to ETrue while the message is being sent to the SMTP server to indicate to the mail editor (and any other clients) that the message is currently in transit and hence should not be opened at this time. The flag is set to EFalse once the attempt to send the message has been completed. Any changes made to the message while the connected flag is set to ETrue will be ignored by the SMTP MTM, i.e. the original message will be sent even if the contents of the message have subsequently been altered by a client.

Failed()

If the MTM is unable to send the email message to the SMTP server, then the Failed flag is set. If there is more than one recipient to the email message, the flag will be set if the message fails to be sent to any of the recipients.

Note that successfully sending an email message to the SMTP server does not mean that the message is guaranteed to be delivered to the recipient(s).

iBioType

Not used by SMTP MTM.

iDate

The time and date the message was originally created.

After an attempt has been made to send the message, iDate will be set to the home time to indicate when that attempt was made.

iDescription

The text from the subject line of the email message

iDetails

The full email address of the first name in the list of recipients (e.g. “John Smith” <[email protected]>)

iError

Error that occurred when attempt was made to send the email message (normally KErrNone).

iMtm

Set to KUidMsgTypeSMTP.

iMtmData1

Reserved.

iMtmData2

Reserved.

iMtmData3

Reserved.

InPreparation()

Not used by SMTP MTM.

iRelatedId

Not used by SMTP MTM.

iServiceId

Identifies the SMTP service that created the message.

iSize

Size, in bytes, of the email message, including all attachments and bodytext

iType

Set to KUidMsvMessageEntry.

MultipleRecipients()

Set to ETrue if the email message is addressed to two or more receipients.

New()

Not used by SMTP MTM.

Operation()

Not used by SMTP MTM.

PcSyncCount()

Not used by SMTP MTM.

ReadOnly()

Not used by SMTP MTM.

SendingState()

When a SMTP session starts, the SMTP MTM checks the outbox folder and automatically appends any email messages to the list of messages it has been instructed to send if those additional messages have the correct IAP setting, and the message is set to KMsvSendStateWaiting state.

Also, SMTP checks for KMsvSendStateSuspended state just before it sends a message.

SMTP also sets the state to KMsvSendStateSent or KMsvSendStateWaiting depending on the error code.

StandardFolder()

Not used by SMTP MTM.

Priority()

Priority of email message.

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

Unread()

Not used by SMTP MTM

Visible()

Set to ETrue on all emails