MSyncMLEventObserver Class Reference

#include <SyncMLObservers.h>

Link against: iaupdatefwupdate.lib

class MSyncMLEventObserver

Public Member Enumerations
enum	TEvent { EJobStart, EJobStartFailed, EJobStop, EJobRejected, ..., EServerTerminated }

Public Member Functions
pure virtual void	OnSyncMLSessionEvent(TEvent, TInt, TInt, TInt)

Detailed Description

Interface to receive notifications of SyncML session events.

Notifications are requested through RSyncMLSession::RequestEventL().

Member Enumeration Documentation

Enum TEvent

SyncML session event types.

Enumerator	Value	Description
EJobStart		Job has started.
EJobStartFailed		Job has failed to start.
EJobStop		Job has stopped.
EJobRejected		Job could not be parsed, and will not be processed.
EProfileCreated		A profile has been created.
EProfileChanged		A profile has been changed.
EProfileDeleted		A profile has been deleted.
ETransportTimeout		A transport has timed-out.
EServerSuspended		The SyncML Agent is suspended. This can occur when processing pauses in order to perform a back-up.
EServerTerminated		The SyncML Agent has shutdown.

Member Function Documentation

OnSyncMLSessionEvent ( TEvent, TInt, TInt, TInt )

void	OnSyncMLSessionEvent	(	TEvent	aEvent,
			TInt	aIdentifier,
			TInt	aError,
			TInt	aAdditionalData
		)	[pure virtual]

Receives a SyncML session event.

The following table lists the meaning of the identifier and error parameters for the various event types.

TEvent				aIdentifier		aError		aAdditionalData	
EJobStart			ID of the new job.	KErrNone.	KUnusedAdditionalData.
EJobStartFailed			Unused.			Reason for fail.	KUnusedAdditionalData.
EJobStop			ID of the job.		Completion code.	KUnusedAdditionalData.
EJobRejected			Unused.			Reason for rejection.	KUnusedAdditionalData.
EProfileCreated			ID of the profile.	Unused.	The usage type( either ESmlDataSync or ESmlDevMan) or an error code.
EProfileChanged			ID of the profile.	Unused.	The usage type( either ESmlDataSync or ESmlDevMan) or an error code.
EProfileDeleted			ID of the profile.	Unused.	KUnusedAdditionalData.
ETransportTimeout		ID of the transport.	KErrTimedOut.	KUnusedAdditionalData.
EServerSuspended		Non-zero if the server	KErrNone when entering. When exiting,  
				is entering suspended 	any error encountered when reloading data.	KUnusedAdditionalData.
				state, zero on exiting.			
EServerTerminated		Unused.			KErrServerTerminated.	KUnusedAdditionalData.

Parameter	Description
aEvent	Event type.
aIdentifier	When the event relates to an object with an ID (job or profile), the ID.
aError	When the event relates to an error, the error code.
aAdditionalData	The value of this parameter can be: KUnusedAdditionalData if additional data are unavailable, ESmlDataSync if the event is generated during a Data Sync session, ESmlDevMan if the event is generated during a Device Management session