Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



CMsvEntry functions for POP3 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 POP3 protocol, and therefore a number of the generic operation functions will return KErrNotSupported if they are called. In particular, POP3 does not support sending 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);

Deletes all specified messages from the remote server.

This command can be stored as an offlline operation if the MTM is running in disconnected mode.

[Top]


Copy from remote function

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

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

Downloads a copy of each of the specified messages and stores them in the local folder specified by aTargetId.

If the message is already populated under the remote service entry, then it is not downloaded again, it is simply copied to the new destination.

[Top]


Move from remote 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-remote functions, except that when a message has been successfully been downloaded, the message entry will be deleted from the remote server.

[Top]


Copy from local 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 local function

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

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

Not supported, returns KErrNotSupported.

[Top]


Copy within service function

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

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

Populates the specified messages.

This function requires that the aTargetId parameter is the service ID, and that the MTM is running in disconnected mode.

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