1 /*

     2 * Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Channel change observer.

    15 *

    16 */

    17 

    18 

    19 #ifndef MSENSRVCHANNELCHANGEHANDLEROBSERVER_H

    20 #define MSENSRVCHANNELCHANGEHANDLEROBSERVER_H

    21 

    22 #include <e32base.h>

    23 #include "sensrvtypes.h"

    24 

    25 

    26 /**

    27  * Channel change observer. Callback interface to indicate when a channel has been 

    28  * added or removed

    29  *  

    30  * @lib SensrvClient.lib

    31  * @since S60 5.0 

    32  */

    33 

    34 class MSensrvChannelChangeHandlerObserver

    35     {

    36     public:

    37         /**

    38         * Indicates channel availability change caused by installation or removal

    39         * of new software. 

    40         *

    41         * @since S60 5.0

    42         * @param[in] aDetectedChannel Channel information of the channel.

    43         * @param[in] aChangeType If ESensrvChannelAdded, channel is a newly available

    44         *                        channel. 

    45         *                        If ESensrvChannelRemoved, channel was removed and is  

    46         *                        no longer available.

    47         */

    48         virtual void ChannelChangeDetected( const TSensrvChannelInfo& aDetectedChannel,

    49                                             TSensrvChannelChangeType aChangeType ) = 0;

    50 

    51         /**

    52         * Channel change listening failed.

    53         * If error was fatal, sensor server session has also been terminated, and

    54         * related finder is no longer usable.

    55         * If error was minor, some notifications have potentially been lost.

    56         *

    57         * @since S60 5.0

    58         * @param[in] aError Error code.

    59         */

    60         virtual void ChannelDetectionError( TSensrvErrorSeverity aError ) = 0;

    61     };

    62 

    63 #endif //MSENSRVCHANNELCHANGEHANDLEROBSERVER_H