MSensrvChannelListener Class Reference

Link against: SensrvClient.lib

#include <sensrvchannellistener.h>

Detailed Description

Channel listener callback interface to indicate when channels have been added or removed.

This class is for use with the CSensrvChannelFinder::SetChannelListenerL() method. Clients wishing to find channels must inherit from this class and provide a reference to an instance of it in CSensrvChannelFinder::SetChannelListenerL().

See also:
CSensrvChannelFinder::SetChannelListenerL()
Dll sensrvclient.lib
Since:
S60 5.0

Public Member Functions

virtual void ChannelChangeDetected (const TSensrvChannelInfo &aDetectedChannel, TSensrvChannelChangeType aChangeType)=0
 Callback implemented by a client so that they can be notified when channels are added or removed from the system when new software is installed or uninstalled.
virtual void ChannelDetectionError (CSensrvChannelFinder &aChannelFinder, TSensrvErrorSeverity aError)=0
 Callback implemented by a client so that they can be notified when channel listening has failed.
virtual void GetChannelListenerInterfaceL (TUid aInterfaceUid, TAny *&aInterface)=0
 Callback to future proof this API so that additional callbacks can be added in the future without breaking binary compatibility.

Member Function Documentation

virtual void MSensrvChannelListener::ChannelChangeDetected ( const TSensrvChannelInfo &  aDetectedChannel,
TSensrvChannelChangeType  aChangeType
)  [pure virtual]
 

Callback implemented by a client so that they can be notified when channels are added or removed from the system when new software is installed or uninstalled.

Clients providing an implementation for this callback must ensure that the operation does not leave. If a leave does occur then the behaviour is undefined.

Since:
S60 5.0
Parameters:
aDetectedChannel Information for the channel that has been added or removed
aChangeType If ESensrvChannelAdded, channel is a newly available channel. If ESensrvChannelRemoved, channel has been removed and is no longer available.
virtual void MSensrvChannelListener::ChannelDetectionError ( CSensrvChannelFinder &  aChannelFinder,
TSensrvErrorSeverity  aError
)  [pure virtual]
 

Callback implemented by a client so that they can be notified when channel listening has failed.

If the error is fatal the sensor server session has been terminated and the channel finder is no longer useable. If the error is minor some notifications have potentially been lost, however listening is still active.

Clients providing an implementation for this callback must ensure that the operation does not leave. If a leave does occur then the behaviour is undefined.

Since:
S60 5.0
Parameters:
aChannelFinder Reference to the related channelfinder object
aError The error severity
virtual void MSensrvChannelListener::GetChannelListenerInterfaceL ( TUid  aInterfaceUid,
TAny *&  aInterface
)  [pure virtual]
 

Callback to future proof this API so that additional callbacks can be added in the future without breaking binary compatibility.

Since:
S60 5.0
Parameters:
aInterfaceUid Identifier for the interface to be retrieved
aInterface A reference to a pointer for the specified interface. Implementation sets aInterface to a valid pointer if the M-class identified by aInterfaceUid is supported, otherwise it is set to NULL on exit.
Leave:
One of the system-wide error codes
The documentation for this class was generated from the following file:
Copyright © Nokia Corporation 2001-2007
Back to top