CMsvEntry functions for SMS 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 SMS protocol, and therefore a number of the generic operation functions will return KErrNotSupported if they are called. In particular, the SMS MTM does not support receiving SMS messages, as this functionality is provided by the SMS watcher.

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

Not supported for messages under the remote service (returns KErrNotSupported).

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

Not supported for messages under the remote service (returns KErrNotSupported).

CMsvOperation* DeleteL(TMsvId aMsvId, TRequestStatus& aStatus)

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

void DeleteL(TMsvId aMsvId);

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

Not supported for messages under the remote service (returns KErrNotSupported).

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

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

Not supported for messages under the remote service (returns KErrNotSupported).

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

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

Not supported for messages under the remote service (returns KErrNotSupported).

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

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

Sends the SMS messages identified in aSelection or by aMsvId. aTargetId should be the ID of the SMS service entry.

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 messages specified in aSelection, the SMS MTM will also attempt to send in the same session any other SMS messages that appear in the outbox for which the SendingState() is set to KMsvSendStateUponRequest, KMsvSendStateWaiting, or KMsvSendStateResend. This intelligence allows messages that have been generated by the Send-As API an opportunity to be sent in user-initiated, or scheduled SMS sessions.

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

CMsvOperation* 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 Symbian OS message store.

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

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

Not supported, returns KErrNotSupported.

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

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

Not supported, returns KErrNotSupported.