Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: popcmtm.h
Link against:

Class CImPop3GetMail

CImPop3GetMail

Support

Supported from 5.0

Description

Provides the means to copy and move email from the remote inbox to any local folder. Functionality is provided to:

When copying or moving email from the remote inbox to a local folder, there are three possibilities to handle:

Derivation

CActiveThe core class of the active object abstraction
CBaseBase class for all classes to be instantiated on the heap
CImPop3GetMailProvides the means to copy and move email from the remote inbox to any local folder
CMsvOperationDefines an interface for use by objects which control asynchronous commands in the messaging system

Defined in CImPop3GetMail:
EConnectAndCopyAllMailAndDisconnect, EConnectAndCopyAllMailAndStayOnline, EConnectAndCopyMailSelectionAndDisconnect, EConnectAndCopyMailSelectionAndStayOnline, EConnectAndCopyNewMailAndDisconnect, EConnectAndCopyNewMailAndStayOnline, EConnectAndMoveAllMailAndDisconnect, EConnectAndMoveAllMailAndStayOnline, EConnectAndMoveMailSelectionAndDisconnect, EConnectAndMoveMailSelectionAndStayOnline, EConnectAndMoveNewMailAndDisconnect, EConnectAndMoveNewMailAndStayOnline, GetMailL(), TImPOP3GetMailType

Inherited from CActive:
Cancel(), Deque(), DoCancel(), EPriorityHigh, EPriorityIdle, EPriorityLow, EPriorityStandard, EPriorityUserInput, IsActive(), IsAdded(), Priority(), RunError(), RunL(), SetActive(), SetPriority(), TPriority, iStatus

Inherited from CBase:
operator new()

Inherited from CMsvOperation:
FinalProgress(), Id(), Mtm(), ProgressL(), Service(), iMsvSession, iMtm, iObserverRequestStatus, iService


GetMailL()

CMsvOperation* GetMailL(CPop3ClientMtm& aPop3ClientMtm, TRequestStatus& aObserverRequestStatus, const CMsvEntrySelection& aMsvEntrySelection, TDes8& aPop3GetMailInfo, TImPOP3GetMailType aPOP3GetMailType);

Description

Get mail

Parameters

CPop3ClientMtm& aPop3ClientMtm

A reference to the POP3 Client MTM that wants to perform the Get Mail operation.

TRequestStatus& aObserverRequestStatus

The status that is completed when the get mail operation has completed

const CMsvEntrySelection& aMsvEntrySelection

The selection of messages that need to be copied or moved to a local folder. The first entry in this selection MUST be the service.

TDes8& aPop3GetMailInfo

Stores the maximum message size and the destination folder id.

TImPOP3GetMailType aPOP3GetMailType

The type of get mail operation to be performed.

Return value

CMsvOperation*

If successful, this is an asynchronously completing operation. If failed, this is a completed operation, with status set to the relevant error code.

[Top]


Enumerations


Enum TImPOP3GetMailType

TImPOP3GetMailType

Description

Type of getmail operation

EConnectAndCopyNewMailAndStayOnline

Connect to mail server, copy new mail and then stay online.

EConnectAndCopyNewMailAndDisconnect

Connect to mail server, copy new mail and then disconnect.

EConnectAndMoveNewMailAndStayOnline

Connect to mail server, move any new mail and then stay online.

EConnectAndMoveNewMailAndDisconnect

Connect to mail server, move any new mail and then disconnect.

EConnectAndCopyMailSelectionAndStayOnline

Connect to mail server, copy selected mail and then stay online.

EConnectAndCopyMailSelectionAndDisconnect

Connect to mail server, copy selected mail and then disconnect.

EConnectAndMoveMailSelectionAndStayOnline

Connect to mail server, move selected mail and then stay online.

EConnectAndMoveMailSelectionAndDisconnect

Connect to mail server, move selected mail and then disconnect.

EConnectAndCopyAllMailAndStayOnline

Connect to mail server, copy all mail and then stay online.

EConnectAndCopyAllMailAndDisconnect

Connect to mail server, copy all mail and then disconnect.

EConnectAndMoveAllMailAndStayOnline

Connect to mail server, move all mail and then stay online.

EConnectAndMoveAllMailAndDisconnect

Connect to mail server, move all mail and then disconnect.