»
UIQ 3.1 SDK »
UIQ API reference »
C++ component reference »
QGsUtils »
CGsResolver
Location:
QGsResolver.h
Link against: qgsutils.lib
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
CBase - Base class for all classes to be instantiated on the heapCGsResolver - Used to determine if a group scheduling event is sent or received
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
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
Return value
static IMPORT_C CGsResolver *NewL(CMsvSession &aSession, CCalEntry &aEntry);
Description
Standard two-phase constructor for resolver class
Parameters
Return value
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 |
|
IMPORT_C TDirection Direction();
Description
Determines the direction (sent/received) for an invitation.
Return value
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 |
|
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 |
|
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 |
|
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 |
|