Class MSyncMLProgressObserver

class MSyncMLProgressObserver;

Description

Interface to receive notifications of SyncML synchronisation progress events.

Notifications are requested through RSyncMLSession::RequestProgressL(MSyncMLProgressObserver &).

Members

Defined in MSyncMLProgressObserver:

• ESmlCompletedSynchronisation has completed.
• ESmlConnectedConnected to a SyncML server.
• ESmlConnectingConnecting to a SyncML server.
• ESmlDisconnectedDisconnected from a SyncML server.
• ESmlFailedToSuspendFailed to suspend. DS only
• ESmlFatalErrorFatal error. A fatal error has occurred. The synchronisation is stopped.
• ESmlLoggedOnLogged on to a SyncML server.
• ESmlLoggingOnLogging on to a SyncML server.
• ESmlProcessingServerCommandsProcessing commands from a SyncML server. DM only
• ESmlReceivingModificationsFromServerReceiving modifications from a SyncML server. DS only
• ESmlReceivingServerCommandsReceiving commands from a SyncML server. DM only
• ESmlSendingMappingsToServerSending mappings to a SyncML server. DS only
• ESmlSendingModificationsToServerSending modifications to a SyncML server. DS only
• ESmlSuspendedSuccesfully suspended. DS only
• ESmlSuspendingAttempting to suspend. DS only
• ESmlUnexpectedDisconnectUnexpected Disconnect
• ESmlWarningWarning. A non-fatal error has occurred. Synchronisation continues.
• OnSyncMLDataSyncModifications(TInt,const TSyncMLDataSyncModifications &,const TSyncMLDataSyncModifications &)Receives notification of modifications to synchronisation tasks.
• OnSyncMLSyncError(TErrorLevel,TInt,TInt,TInt,TInt)Receives notification of a synchronisation error.
• OnSyncMLSyncProgress(TStatus,TInt,TInt)Receives notification of synchronisation progress.
• TErrorLevel SyncML error levels.
• TStatus SyncML synchronisation progress events.
• TSyncMLDataSyncModificationsContainer class for number of items added, replaced, moved, deleted and failed.

virtual void OnSyncMLSyncError(TErrorLevel aErrorLevel, TInt aError, TInt aTaskId, TInt aInfo1, TInt aInfo2)=0;

Description

Receives notification of a synchronisation error.

Parameters

MSyncMLProgressObserver::TErrorLevel aErrorLevel The error level. TInt aError The type of error. This is one of the SyncMLError error values. TInt aTaskId The ID of the task for which the error occurred. TInt aInfo1 An integer that can contain additional information about the error. Normally 0. TInt aInfo2 An integer that can contain additional information about the error. Normally 0.

virtual void OnSyncMLSyncProgress(TStatus aStatus, TInt aInfo1, TInt aInfo2)=0;

Description

Receives notification of synchronisation progress.

Parameters

MSyncMLProgressObserver::TStatus aStatus The current status, e.g. 'Connecting'. TInt aInfo1 An integer that can contain additional information about the error. Normally 0. TInt aInfo2 An integer that can contain additional information about the error. Normally 0.

virtual void OnSyncMLDataSyncModifications(TInt aTaskId, const TSyncMLDataSyncModifications &aClientModifications, const TSyncMLDataSyncModifications &aServerModifications)=0;

Description

Receives notification of modifications to synchronisation tasks.

Parameters

TInt aTaskId The ID of the task. const MSyncMLProgressObserver::TSyncMLDataSyncModifications &aClientModifications Modifications made on the clients Data Store. const MSyncMLProgressObserver::TSyncMLDataSyncModifications &aServerModifications Modifications made on the server Data Store.

class TSyncMLDataSyncModifications;

Description

Container class for number of items added, replaced, moved, deleted and failed.

Members

Defined in MSyncMLProgressObserver::TSyncMLDataSyncModifications:

• iNumAdded
• iNumDeleted
• iNumFailed
• iNumMoved
• iNumReplaced

Member data

---

iNumAdded

TInt iNumAdded;

Description

---

iNumReplaced

TInt iNumReplaced;

Description

---

iNumMoved

TInt iNumMoved;

Description

---

iNumDeleted

TInt iNumDeleted;

Description

---

iNumFailed

TInt iNumFailed;

Description

TStatus

Description

SyncML synchronisation progress events.

ESmlConnecting Connecting to a SyncML server. ESmlConnected Connected to a SyncML server. ESmlLoggingOn Logging on to a SyncML server. ESmlLoggedOn Logged on to a SyncML server. ESmlDisconnected Disconnected from a SyncML server. ESmlCompleted Synchronisation has completed. ESmlSendingModificationsToServer Sending modifications to a SyncML server. DS only ESmlReceivingModificationsFromServer Receiving modifications from a SyncML server. DS only ESmlSendingMappingsToServer Sending mappings to a SyncML server. DS only ESmlProcessingServerCommands Processing commands from a SyncML server. DM only ESmlReceivingServerCommands Receiving commands from a SyncML server. DM only ESmlSuspending Attempting to suspend. DS only ESmlSuspended Succesfully suspended. DS only ESmlFailedToSuspend Failed to suspend. DS only ESmlUnexpectedDisconnect Unexpected Disconnect

TErrorLevel

Description

SyncML error levels.

ESmlWarning Warning. A non-fatal error has occurred. Synchronisation continues. ESmlFatalError Fatal error. A fatal error has occurred. The synchronisation is stopped.