Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



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.


Create function

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

Not supported, returns KErrNotSupported.

[Top]


Change function

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

Not supported, returns KErrNotSupported.

[Top]


Delete function

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.

[Top]


Copy from remote function

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

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

Not supported, returns KErrNotSupported.

[Top]


Move from remote function

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

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

Not supported, returns KErrNotSupported.

[Top]


Copy from local function

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:

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

[Top]


Move from local function

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.

[Top]


Copy within service function

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

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

Not supported, returns KErrNotSupported.

[Top]


Move within service function

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

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

Not supported, returns KErrNotSupported.