Class CSyncMLHistoryJob

class CSyncMLHistoryJob : public CSyncMLHistoryEntry;

Description

This class holds the result of a session with a server.

Derivation

• CBase - Base class for all classes to be instantiated on the heap

• CSyncMLHistoryEntry - Base class for a history log entry

• CSyncMLHistoryJob - This class holds the result of a session with a server

Members

Defined in CSyncMLHistoryJob:
DynamicCast(), DynamicCast(), ExternalizeL(), FinishTime(), InternalizeL(), NewL(), NewL(), Profile(), ResultCode(), SetResult(), TTaskInfo, TaskAt(), TaskById(), TaskCount(), TimeStamp(), ~CSyncMLHistoryJob()

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

Inherited from CSyncMLHistoryEntry:
ESortByTime, ESortByType, EntryId(), EntryType(), Reserved(), TSortOrder

static IMPORT_C CSyncMLHistoryJob *NewL();

Description

This method creates a new Job History entry representing a Sync Job.

Return value

CSyncMLHistoryJob * New Job History entry

Leave codes

KErrNoMemory Insufficient free system RAM.

static IMPORT_C CSyncMLHistoryJob *NewL(TSmlProfileId, const RArray< TSmlTaskId > &);

Description

This method creates a new Job History entry representing a Sync Job.

Parameters

TSmlProfileId The ID of the Profile the Job is associated with const RArray< TSmlTaskId > & The set of Tasks the Job is synchronising.

Return value

CSyncMLHistoryJob * New Job History entry

Leave codes

KErrNoMemory Insufficient free system RAM.

virtual IMPORT_C ~CSyncMLHistoryJob();

Description

Destructor for CSyncMLHistoryJob

static inline CSyncMLHistoryJob *DynamicCast(CSyncMLHistoryEntry *);

Description

Parameters

CSyncMLHistoryEntry *

Return value

CSyncMLHistoryJob *

static inline const CSyncMLHistoryJob *DynamicCast(const CSyncMLHistoryEntry *);

Description

Parameters

const CSyncMLHistoryEntry *

Return value

const CSyncMLHistoryJob *

virtual IMPORT_C void ExternalizeL(RWriteStream &) const;

Description

This method writes the details associated with this entry to the specified stream.

Parameters

RWriteStream & The stream to write the entry to.

virtual IMPORT_C TSmlProfileId Profile() const;

Description

This method returns the ID of the Server Profile that this entry is associated with. Returns KSmlNullId if this entry is not associated with any Profile.

Return value

TSmlProfileId The ID of the Server Profile that this entry is associated with.

virtual IMPORT_C TTime TimeStamp() const;

Description

This method returns the time stamp of this entry. i.e. when the Job started.

Return value

TTime The time stamp in Universal Time.

virtual IMPORT_C TInt ResultCode() const;

Description

This method returns the result of the Sync Job.

Return value

TInt The error code that the job completed with.

IMPORT_C TTime FinishTime() const;

Description

This method returns the time that the Sync Job completed.

Return value

TTime The finish time in Universal Time.

IMPORT_C TInt TaskCount() const;

Description

This method returns the number of tasks that were synchronised by the Job this entry represents.

Return value

TInt The number of tasks.

IMPORT_C const TTaskInfo &TaskAt(TInt) const;

Description

This method returns the task information at the specified index in the entry.

Parameters

TInt The index of the task to fetch.

Return value

const TTaskInfo & The task information at the specified index.

IMPORT_C TTaskInfo &TaskById(TSmlTaskId);

Description

This method returns a modifiable reference to the information for the specified task.

Parameters

TSmlTaskId Identifies the task.

Return value

TTaskInfo & The information for the specified task.

Panic codes

SmlHistory::Shared ESmlPanicHistoryShared_BadTaskId The specified task is not a part of this entry.

IMPORT_C void SetResult(TTime aFinishTime, TInt aResultCode);

Description

This method sets the finish time, and result code for the Sync Job entry.

Parameters

TTime aFinishTime The time the Job completed. TInt aResultCode The result of the Job.

private: virtual void InternalizeL(RReadStream &);

Description

Parameters

RReadStream &

class TTaskInfo;

Description

This class identifies a sync task within the profile, and the result of the attempt to synchronise it.

Members

Defined in CSyncMLHistoryJob::TTaskInfo:
ExternalizeL(), InternalizeL(), TTaskInfo(), iError, iItemsAdded, iItemsChanged, iItemsDeleted, iItemsFailed, iItemsMoved, iServerItemsAdded, iServerItemsChanged, iServerItemsDeleted, iServerItemsFailed, iServerItemsMoved, iSyncType, iTaskId

Construction and destruction

---

TTaskInfo()

IMPORT_C TTaskInfo();

Description

Default constructor for TTaskInfo.

Member functions

---

InternalizeL()

IMPORT_C void InternalizeL(RReadStream &);

Description

This method reads a TTaskInfo object from a stream.

Parameters

RReadStream & A stream containing a valid TTaskInfo object.

---

ExternalizeL()

IMPORT_C void ExternalizeL(RWriteStream &) const;

Description

This method writes a TTaskInfo object to a stream.

Parameters

RWriteStream & A stream to write the object to.

Member data

---

iTaskId

TSmlTaskId iTaskId;

Description

Identifies the profile sync task

---

iError

TInt iError;

Description

Indicates the synchronisation result

---

iItemsAdded

TInt iItemsAdded;

Description

Indicates the number of items added to the db

---

iItemsChanged

TInt iItemsChanged;

Description

Indicates the number of items modified in the db

---

iItemsDeleted

TInt iItemsDeleted;

Description

Indicates the number of items deleted from the db

---

iItemsMoved

TInt iItemsMoved;

Description

Indicates the number of items moved in the db

---

iItemsFailed

TInt iItemsFailed;

Description

Indicates the number of items that failed synchronisation

---

iServerItemsAdded

TInt iServerItemsAdded;

Description

Indicates the number of items added on the server

---

iServerItemsDeleted

TInt iServerItemsDeleted;

Description

Indicates the number of items deleted on the server

---

iServerItemsMoved

TInt iServerItemsMoved;

Description

Indicates the number of items moved on the server

---

iServerItemsChanged

TInt iServerItemsChanged;

Description

Indicates the number of items changed on the server

---

iServerItemsFailed

TInt iServerItemsFailed;

Description

Indicates the number of items failed synchronisation on the server

---

iSyncType

TSmlSyncType iSyncType;

Description

Indicates the Synchronisation type used for the task.