MESMRUtilsTombsExt Class Reference

class MESMRUtilsTombsExt

Extension API for CMRUtils.

Usage (assuming you have CMRUtils* iUtils): MESMRUtilsTombsExt* ext = ExtensionApiL<MESMRUtilsTombsExt>( iUtils );

Member Functions Documentation

DeleteL(const TDesC8 &)

voidDeleteL(const TDesC8 &aUid)[pure virtual]

Delete entry from Agenda Model if found and create tombstone(s). This method causes deletion of all entries with given GUID.

Parameters

const TDesC8 & aUiddetermines entry to be deleted

DeleteL(const TCalLocalUid &)

voidDeleteL(const TCalLocalUid &aLocalUid)[pure virtual]

Delete entry from Agenda Model if found and create tombstone(s). This method causes deletion of a modifying entry, or entire recurring event if aLocalUid corresponds to an originating entry.

Parameters

const TCalLocalUid & aLocalUiddetermines entry to be deleted

DeleteL(const CCalEntry &)

voidDeleteL(const CCalEntry &aCalEntry)[pure virtual]

Delete entry from Agenda Model if found and create tombstone(s). This method causes deletion of a modifying entry, or entire recurring event if aCalEntry is an originating entry.

Parameters

const CCalEntry & aCalEntryentry to be deleted

DeleteL(const CalCommon::TCalTimeRange &)

voidDeleteL(const CalCommon::TCalTimeRange &aCalTimeRange)[pure virtual]

Delete entries from Agenda Model if found and create tombstone(s). This is asynchronous, user gets notified with MMRUtilsObserver::HandleOperation( EDeleteEntries,... )

Parameters

const CalCommon::TCalTimeRange & aCalTimeRangedetermines entries to be deleted

ExtensionUid()

TUid ExtensionUid()[static, inline]

Fetches the extension UID for Thombstone extension

StoreL(CCalEntry &, TBool)

TESMRUtilsDbResult StoreL(CCalEntry &aCalEntry,
TBoolaResurrect
)[pure virtual]

Store entry to Agenda Model conditionally using entry validation and tombstone logic. Attempts to resolves and set entry's phone owner field before saving if currently unset. Resurrection of a modifying entry will leave if originating entry does not exist in the Agenda Model.

Parameters

CCalEntry & aCalEntryentry to store, phone owner is set if resolvable
TBool aResurrectif ETrue then entry stored even if it has been previously deleted

Member Enumerations Documentation

Enum TESMRUtilsDbResult

Result codes for database operations. Evalutation is done purely on entry basis, not on request or method level. E.g. EStoredNew means that given originating or modifying entry does not exist in the phone. EStoredUpdate on the other hand means that entry with the same UID and RECURRENCE-ID existed and was updated. Another example: a cancellation may be a valid new entry from the database point of view, but it is still questionable whether it is a valid cancellation if the corresponding request does not exist.

Enumerators

EErrorContent = -100
EErrorRecurrence
EErrorObsolete
EErrorHasBeenDeleted
EErrorIdenticalExists
EErrorCancelled
EUndefined = 0
ECheckedValidNew
ECheckedValidUpdate
EStoredNew
EStoredUpdate
EResurrectedDeleted
EResurrectedCancelled