Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



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.


Create function

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

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

[Top]


Change function

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

Not supported for messages under the remote service (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 for messages under the remote service (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 for messages under the remote service (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 for messages under the remote service (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 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.

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

[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.