#include <cenrepnotifyhandler.h>
Link against: cenrepnotifhandler.lib
| class MCenRepNotifyHandlerCallback |
| Public Member Functions | |
|---|---|
| virtual IMPORT_C void | HandleNotifyBinary(TUint32, const TDesC8 &) |
| virtual IMPORT_C void | HandleNotifyError(TUint32, TInt, CCenRepNotifyHandler *) |
| virtual IMPORT_C void | HandleNotifyGeneric(TUint32) |
| virtual IMPORT_C void | HandleNotifyInt(TUint32, TInt) |
| virtual IMPORT_C void | HandleNotifyReal(TUint32, TReal) |
| virtual IMPORT_C void | HandleNotifyString(TUint32, const TDesC16 &) |
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.
This callback method is used to notify the client about changes for binary value keys, i.e. key type is EBinaryKey.
| Parameters | |
|---|---|
| aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |
| 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.
| Parameters | |
|---|---|
| aId | Id of the key this instance listens to or if notifications for whole repository are listened, could also be KInvalidNotificationId. |
| aError | Error code. |
| aHandler | Pointer to the handler instance. This pointer can be used to identify the handler or restart the listening. |
| Capability | |
|---|---|
| Dependent | Capability required depends on implementation of override. |
| 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.
| Parameters | |
|---|---|
| aId | Id of the key that has changed. If multiple keys were changed by whole repository reset, value will be KInvalidNotificationId. |
| Capability | |
|---|---|
| Dependent | Capability required depends on implementation of override. |
This callback method is used to notify the client about changes for integer value keys, i.e. key type is EIntKey.
| Parameters | |
|---|---|
| aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |
| Capability | |
|---|---|
| Dependent | Capability required depends on implementation of override. |
This callback method is used to notify the client about changes for real value keys, i.e. key type is ERealKey.
| Parameters | |
|---|---|
| aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |
| Capability | |
|---|---|
| Dependent | Capability required depends on implementation of override. |
This callback method is used to notify the client about changes for string value keys, i.e. key type is EStringKey.
| Parameters | |
|---|---|
| aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |
| Capability | |
|---|---|
| Dependent | Capability required depends on implementation of override. |