| class MCenRepNotifyHandlerCallback |
Class provides a callback interface for handling the notifification events from the Central Repository. The Client derives a class from this interface and implements the HandleNotify-methods that interest it. An empty default implementation is provided for all of the methods. In debug build the default implementations print out a debug trace.
| Public Member Functions | |
|---|---|
| IMPORT_C void | HandleNotifyBinary(TUint32, const TDesC8 &) |
| IMPORT_C void | HandleNotifyError(TUint32, TInt, CCenRepNotifyHandler *) |
| IMPORT_C void | HandleNotifyGeneric(TUint32) |
| IMPORT_C void | HandleNotifyInt(TUint32, TInt) |
| IMPORT_C void | HandleNotifyReal(TUint32, TReal) |
| IMPORT_C void | HandleNotifyString(TUint32, const TDesC16 &) |
| IMPORT_C void | HandleNotifyBinary | ( | TUint32 | aId, |
| const TDesC8 & | aNewValue | |||
| ) | [virtual] | |||
This callback method is used to notify the client about changes for binary value keys, i.e. key type is EBinaryKey.
capability
Dependent Capability required depends on implementation of override.
| IMPORT_C void | HandleNotifyError | ( | TUint32 | aId, |
| TInt | aError, | |||
| CCenRepNotifyHandler * | aHandler | |||
| ) | [virtual] | |||
This callback method is used to notify the client about errors in the handler. Any error in handling causes the handler to stop handling any more notifications. Handling can be restarted with a call to aHandler->StartListeningL(), if the error is non-fatal. However, be careful to trap any errors from this call if this is done.
capability
Dependent Capability required depends on implementation of override.
| TUint32 aId | Id of the key this instance listens to or if notifications for whole repository are listened, could also be KInvalidNotificationId. |
| TInt aError | Error code. |
| CCenRepNotifyHandler * aHandler | Pointer to the handler instance. This pointer can be used to identify the handler or restart the listening. |
| IMPORT_C void | HandleNotifyGeneric | ( | TUint32 | aId | ) | [virtual] |
This callback method is used to notify the client about changes in keys when the whole repository is listened for.
Note: It is not guaranteed that a notification will be received for all keys, if multiple keys are changed in rapid succession by multiple threads or when the whole repository is reset, therefore only listen for whole repository if this is not an issue.
capability
Dependent Capability required depends on implementation of override.
| TUint32 aId | Id of the key that has changed. If multiple keys were changed by whole repository reset, value will be KInvalidNotificationId. |
| IMPORT_C void | HandleNotifyInt | ( | TUint32 | aId, |
| TInt | aNewValue | |||
| ) | [virtual] | |||
This callback method is used to notify the client about changes for integer value keys, i.e. key type is EIntKey.
capability
Dependent Capability required depends on implementation of override.
| IMPORT_C void | HandleNotifyReal | ( | TUint32 | aId, |
| TReal | aNewValue | |||
| ) | [virtual] | |||
This callback method is used to notify the client about changes for real value keys, i.e. key type is ERealKey.
capability
Dependent Capability required depends on implementation of override.
| IMPORT_C void | HandleNotifyString | ( | TUint32 | aId, |
| const TDesC16 & | aNewValue | |||
| ) | [virtual] | |||
This callback method is used to notify the client about changes for string value keys, i.e. key type is EStringKey.
capability
Dependent Capability required depends on implementation of override.