CMsvEntry functions for SMTP message entries

The messaging architecture supplies a generic interface, CMsvEntry, for manipulating message entries. Not all generic operations are meaningful in the context of the SMTP protocol, and therefore a number of the generic operation functions will return KErrNotSupported if they are called. In particular, SMTP does not support retrieving email.

CMsvFunction* CreateL(const TMsvEntry& aEntry, TRequestStatus& aStatus)

Not supported, returns KErrNotSupported.

CMsvFunction* ChangeL(const TMsvEntry& aEntry, TRequestStatus& aStatus)

Not supported, returns KErrNotSupported.

CMsvFunction* DeleteL(TMsvId aMsvId, TRequestStatus& aStatus)

CMsvFunction* DeleteL(const CMsvEntrySelection& aSelection, TRequestStatus& aStatus)

void DeleteL(TMsvId aMsvId);

void DeleteL(const CMsvEntrySelection& aSelection, TMsvLocalOperationProgress& aProgress);

Not supported, returns KErrNotSupported.

CMsvFunction* CopyL(const CMsvEntrySelection& aSelection, TMsvId aTargetId, TRequestStatus& aStatus)

CMsvFunction* CopyL(TMsvId aMsvId, TMsvId aTargetId, TRequestStatus& aStatus)

Not supported, returns KErrNotSupported.

CMsvFunction* MoveL(const CMsvEntrySelection& aSelection, TMsvId aTargetId, TRequestStatus& aStatus)

CMsvFunction* MoveL(TMsvId aMsvId, TMsvId aTargetId, TRequestStatus& aStatus)

Not supported, returns KErrNotSupported.

CMsvFunction* CopyL(const CMsvEntrySelection& aSelection, TMsvId aTargetId, TRequestStatus& aStatus)

CMsvFunction* CopyL(TMsvId aMsvId, TMsvId aTargetId, TRequestStatus& aStatus)

Sends the specified email messages to the SMTP server identified by aTargetId.

Messages will only be sent if the TMsvEntry::SendingState() for a message entry is set to one of the following states: KMsvSendStateUponRequest, KMsvSendStateWaiting, or KMsvSendStateResend.

When a message has been successfully been sent, the message entry will be moved into the Sent folder, if this folder exists.

In addition to the specified messages the SMTP MTM will also attempt to send in the same session any other SMTP messages that appear in the outbox which conform to the following criteria:

• the message is associated with an IAP that is used by the service identified by aTargetId

• TMsvEntry::SendingState() is set to KMsvSendStateUponRequest, KMsvSendStateWaiting, or KMsvSendStateResend

This intelligence allows messages generated by CSendAs to be sent in user-initiated mail sessions.

CMsvFunction* MoveL(const CMsvEntrySelection& aSelection, TMsvId aTargetId, TRequestStatus& aStatus)

CMsvFunction* MoveL(TMsvId aMsvId, TMsvId aTargetId, TRequestStatus& aStatus)

This is treated as for the copy-from-local functions, except that when a message has been successfully been sent, the message entry will be deleted from the remote server.

CMsvFunction* CopyL(const CMsvEntrySelection& aSelection, TMsvId aTargetId, TRequestStatus& aStatus)

CMsvFunction* CopyL(TMsvId aMsvId, TMsvId aTargetId, TRequestStatus& aStatus)

Not supported, returns KErrNotSupported.

CMsvFunction* MoveL(const CMsvEntrySelection& aSelection, TMsvId aTargetId, TRequestStatus& aStatus)

CMsvFunction* MoveL(TMsvId aMsvId, TMsvId aTargetId, TRequestStatus& aStatus)

Not supported, returns KErrNotSupported.