Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <CImAttachmentWaiter.h>
Link against: imcm.lib
This item is not part of the S60 5th Edition SDK

Class CImAttachmentWaiter

class CImAttachmentWaiter : public CActive;

Description

An Waiter object used to wait for an attachment to be added to an email message.

Derivation

Members

Defined in CImAttachmentWaiter:

Inherited from CActive:

Inherited from CBase:


Construction and destruction


NewL()

IMPORT_C static CImAttachmentWaiter* NewL();

Description

Allocates & Creates a new CImAttachmentWaiter object.

Return value

CImAttachmentWaiter *

A pointer to the newly created object


~CImAttachmentWaiter()

IMPORT_C ~CImAttachmentWaiter();

Description

Cancels the outstanding request. Frees all resources owned by the object prior to its destruction

[Top]


Member functions


StartWaitingL(TRequestStatus &,CImEmailMessage *,TBool)

IMPORT_C void StartWaitingL(TRequestStatus &aStatus, CImEmailMessage *aMailMessage, TBool aDeleteMessage=ETrue);

Description

Issues a waiting request for adding an attachment .

Parameters

TRequestStatus &aStatus

The TRequestStatus to complete when request has completed.

CImEmailMessage *aMailMessage

The CImEmailMessage pointer to which the attahcment is to be added

TBool aDeleteMessage

TBool indicating if the CImEmailMessage needs to be deleted when CImAttachmentWaiter is Reset or destroyed

Leave codes

KErrInUse


RunL()

private: virtual void RunL();

Description

Handles an active object's request completion event.

A derived class must provide an implementation to handle the completed request. If appropriate, it may issue another request.

The function is called by the active scheduler when a request completion event occurs, i.e. after the active scheduler's WaitForAnyRequest() function completes.

Before calling this active object's CImAttachmentWaiter::RunL() function, the active scheduler has:

1. decided that this is the highest priority active object with a completed request

2. marked this active object's request as complete (i.e. the request is no longer outstanding)

CImAttachmentWaiter::RunL() runs under a trap harness in the active scheduler. If it leaves, then the active scheduler calls CActive::RunError(TInt) to handle the leave.

Note that once the active scheduler's Start() function has been called, all user code is run under one of the program's active object's CImAttachmentWaiter::RunL() or CActive::RunError(TInt) functions.

See also:


DoCancel()

private: virtual void DoCancel();

Description

It cancels an outstanding request.