UIQ Technology
Symbian OS Library

UIQ 3.1 SDK        UIQ developer portal

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



Location: QGsResolver.h
Link against: qgsutils.lib

Class CGsResolver

class CGsResolver : public CBase;

Description

Used to determine if a group scheduling event is sent or received. It also contains functionality for matching e-mail addresses to e-mail accounts

Derivation

Members

Defined in CGsResolver:
Direction(), EDirectionReceived, EDirectionSent, EDirectionUnknown, GetMailServiceId(), NewL(), NewL(), SetOrganizerAddressL(), SetOrganizerL(), TDirection, UpdatePhoneOwnerL()

Inherited from CBase:
Delete(), Extension_(), operator new()


Construction and destruction


NewL()

static IMPORT_C CGsResolver *NewL(CMsvSession &aSession);

Description

Standard two-phase constructor for resolver class, this variant is only to be used together with SetOrganizerAddressL()

Parameters

CMsvSession &aSession

Session to Messaging server

Return value

CGsResolver *

Fully constructed resolver object


NewL()

static IMPORT_C CGsResolver *NewL(CMsvSession &aSession, CCalEntry &aEntry);

Description

Standard two-phase constructor for resolver class

Parameters

CMsvSession &aSession

Session to Messaging server

CCalEntry &aEntry

Calendar entry to be analyzed

Return value

CGsResolver *

Fully constructed resolver object

[Top]


Member functions


UpdatePhoneOwnerL()

IMPORT_C void UpdatePhoneOwnerL(const TMsvEntry &aRecvId);

Description

Set the phone owner property of the calendar entry by matching the e-mail addresses against e-mail accounts. Used on incoming/received invitations.

Parameters

const TMsvEntry &aRecvId

Received invitation e-mail entry

Leave codes

KErrArgument

No valid e-mail address for corresponding e-mail account

KErrNotFound

None of the attendees match the email address of the mail account where the mail was received


Direction()

IMPORT_C TDirection Direction();

Description

Determines the direction (sent/received) for an invitation.

Return value

TDirection

Direction of invitation


GetMailServiceId()

IMPORT_C TInt GetMailServiceId(TMsvId &aId);

Description

Determines the e-mail account that corresponds to the CCalEntry object passed in to NewL. Both POP3, IMAP and 3rd-party MTMs are used in the lookup.

Parameters

TMsvId &aId

If method returns KErrNone this is the (Sending) service id for the e-mail account matching the calendar entry

Return value

TInt

KErrNotFound if no matching e-mail account is found


SetOrganizerL()

IMPORT_C void SetOrganizerL();

Description

Used before sending a CCalEntry invitation. The e-mail address of the default e-mail account is set as organizer. It also makes the organizer = phone owner. If the Organizer is not NULL, the entry will not be modified.

Leave codes

standard

leave codes, e.g. if no e-mail account exists


SetOrganizerAddressL()

IMPORT_C void SetOrganizerAddressL(TDes &aAddr);

Description

Used before sending a CCalEntry invitation. Used to retrieve the e-mail address of the default e-mail account. No CCalEntry object is required, use CGsResolver::NewL(CMsvSession& aSession).

Parameters

TDes &aAddr

The e-mail address for the default e-mail account.

Leave codes

standard

leave codes, e.g. if no e-mail account exists

[Top]


Member enumerations


Enum TDirection

TDirection

Description

Used to keep track of the inviatiation state for a given GS entry

EDirectionUnknown

Cannot determine if it is a sent or received invitation. Entry could be synchronized into the device and the e-mail accounts does not match.

EDirectionSent

Entry has been sent by the phone owner

EDirectionReceived

Entry has been received by the phone owner