1 /*

     2 * Copyright (c) 2002-2008 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:    In case that Service Consumer (owner of SC instance) needs

    15 *                some special, even properietary interface, it can request

    16 *                an implementation of such interface by calling

    17 *                CSenServiceConnection::InterfaceByUid(UID) and acquire

    18 *                on of the M-class interfaces defined in this file.

    19 *

    20 */

    21 

    22 

    23 

    24 

    25 #ifndef M_SEN_SERVICE_CONNNECTION_INTERFACES_H

    26 #define M_SEN_SERVICE_CONNNECTION_INTERFACES_H

    27 

    28 // CONST

    29 // UIDs for the supported, new *service connection interfaces*:

    30 const TUid KSenInterfaceUidAlrServiceConnection      = { 0xE760F699 }; // MSenAlrServiceConnection

    31 

    32 

    33 // CLASS DECLARATION

    34 /**

    35  * Callback interface for service consumers

    36  */

    37     

    38 class MSenAlrServiceConnection

    39     {

    40     public: 

    41         /**

    42         * With this method client can indicate that it wants to start using a new preferred 

    43         * connection as a response to PreferredCarrierAvailable() callback.

    44         *

    45         * @param aUserChoice TRUE(Yes) FALSE (No)

    46         * if UserChoice is TRUE then connection will migrated to new carrier

    47         * available,         

    48         * if UserChoice is FALSE connection will not migrate to new carrier        

    49         */

    50 	    virtual void MigrateToPrefferedCarrierL(TBool &aUserChoice) = 0 ;

    51 

    52         /**

    53         * With this method client can indicate that it accepts to use a new preferred 

    54         * connection as a response to NewCarrierActive() callback.

    55         * 

    56         * Earlier the client has received MigrateToPrefferedCarrierL()

    57         * callback. Once it has agreed to migrate through NewCarrierAvailable(),

    58         * newCarrierActive() callback will be invoked in order

    59         * to get acceptance from the application.

    60         *

    61         * @param aUserChoice TRUE(Yes) FALSE (No)

    62         * if UserChoice is TRUE then new Carrier will be accepted

    63         * if UserChoice is FALSE connection will not accept the new carrier        

    64         */

    65 	    virtual void NewCarrierAcceptedL(TBool &aUserChoice) = 0 ;		

    66     };    

    67     

    68 #endif //  M_SEN_SERVICE_CONNNECTION_INTERFACES_H