MCenRepNotifyHandlerCallback Class Reference
#include
<cenrepnotifyhandler.h>
Link against: cenrepnotifhandler.lib
| class MCenRepNotifyHandlerCallback |
Detailed Description
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.
Member Function Documentation
HandleNotifyBinary ( TUint32, const TDesC8 & )
| 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.
| Parameter | Description | | aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |
HandleNotifyError ( TUint32, TInt, CCenRepNotifyHandler * )
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.
| Parameter | Description | | 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. |
HandleNotifyGeneric ( TUint32 )
| 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.
| Parameter | Description | | aId | Id of the key that has changed. If multiple keys were changed by whole repository reset, value will be KInvalidNotificationId. |
HandleNotifyInt ( TUint32, TInt )
| 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.
| Parameter | Description | | aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |
HandleNotifyReal ( TUint32, TReal )
| 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.
| Parameter | Description | | aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |
HandleNotifyString ( TUint32, const TDesC16 & )
| 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.
| Parameter | Description | | aId | Id of the key that has changed. |
| aNewValue | The new value of the key. |