Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



Location: SyncMLHistory.h
Link against: smlclient.lib

This item is not part of the S60 3rd Edition SDK for Symbian OS, Feature Pack 2.

Class CSyncMLHistoryJob

class CSyncMLHistoryJob : public CSyncMLHistoryEntry;

Description

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

Derivation

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


Construction and destruction


NewL()

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.


NewL()

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.


~CSyncMLHistoryJob()

virtual IMPORT_C ~CSyncMLHistoryJob();

Description

Destructor for CSyncMLHistoryJob

[Top]


Member functions


DynamicCast()

static inline CSyncMLHistoryJob *DynamicCast(CSyncMLHistoryEntry *);

Description

Parameters

CSyncMLHistoryEntry *

Return value

CSyncMLHistoryJob *


DynamicCast()

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

Description

Parameters

const CSyncMLHistoryEntry *

Return value

const CSyncMLHistoryJob *


ExternalizeL()

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.


Profile()

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.


TimeStamp()

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.


ResultCode()

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.


FinishTime()

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.


TaskCount()

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.


TaskAt()

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.


TaskById()

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.


SetResult()

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.


InternalizeL()

private: virtual void InternalizeL(RReadStream &);

Description

Parameters

RReadStream &

[Top]


Member classes


Class TTaskInfo

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.