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)

void CheckUpdatesComplete ( TInt aErrorCode,
TInt aAvailableUpdates
) [pure virtual]

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

Since
S60 v3.2

Parameters

TInt aErrorCode The error code of the observed update operation. KErrNone for successful completion, otherwise a system wide error code.
TInt aAvailableUpdates Number of the updates that were found available.

UpdateComplete(TInt, CIAUpdateResult *)

void UpdateComplete ( TInt aErrorCode,
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 aErrorCode The error code of the completed update operation. KErrNone for successful completion, otherwise a system wide error code.
CIAUpdateResult * aResult Details about the completed update operation. Ownership is transferred.

UpdateQueryComplete(TInt, TBool)

void UpdateQueryComplete ( TInt aErrorCode,
TBool aUpdateNow
) [pure virtual]

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

Since
S60 v3.2

Parameters

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