MIAUpdateObserver Class Reference

class MIAUpdateObserver

MIAUpdateObserver provides callback functions that the updater will call when an update operation has been completed.

Note:

If an update is targeted to multiple items during one operation call, the observer is informed only once about the completion. This is done, when the update operation as a whole has been completed.

When the application updates itself, installation requires the shutdown of the application. Then, the updater will continue the update operation in the background but callbacks to nonexisting observers are skipped. After installation is finished, the updated application will be restarted if that information is included in CIAUpdateParameters.

An application may also update itself without a need for restart. For example, when plug-ins are retrieved for the application. Then, the callback functions of the observer can be called from the updater. And, the observer will know when the necessary updates have been installed.

CIAUpdate CIAUpdateParameters CIAUpdateResult
Since
S60 v3.2

Member Functions Documentation

CheckUpdatesComplete(TInt, TInt)

voidCheckUpdatesComplete(TIntaErrorCode,
TIntaAvailableUpdates
)[pure virtual]

This callback function is called when the update checking operation has completed.

Since
S60 v3.2

Parameters

TInt aErrorCodeThe error code of the observed update operation. KErrNone for successful completion, otherwise a system wide error code.
TInt aAvailableUpdatesNumber of the updates that were found available.

UpdateComplete(TInt, CIAUpdateResult *)

voidUpdateComplete(TIntaErrorCode,
CIAUpdateResult *aResult
)[pure virtual]

This callback function is called when an update operation has completed. Even if multiple functions are provided to start different update operations, this callback function is always called after an update operation has completed.

Since
S60 v3.2

Parameters

TInt aErrorCodeThe error code of the completed update operation. KErrNone for successful completion, otherwise a system wide error code.
CIAUpdateResult * aResultDetails about the completed update operation. Ownership is transferred.

UpdateQueryComplete(TInt, TBool)

voidUpdateQueryComplete(TIntaErrorCode,
TBoolaUpdateNow
)[pure virtual]

This callback function is called when an update query operation has completed.

Since
S60 v3.2

Parameters

TInt aErrorCodeThe error code of the observed query operation. KErrNone for successful completion, otherwise a system wide error code.
TBool aUpdateNowETrue informs that an update operation should be started. EFalse informs that there is no need to start an update operation.