/*

* Copyright (c) 2002-2008 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

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

* which accompanies this distribution, and is available

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

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:    In case that Service Consumer (owner of SC instance) needs

*                some special, even properietary interface, it can request

*                an implementation of such interface by calling

*                CSenServiceConnection::InterfaceByUid(UID) and acquire

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

*

*/

#ifndef M_SEN_SERVICE_CONNNECTION_INTERFACES_H

#define M_SEN_SERVICE_CONNNECTION_INTERFACES_H

// CONST

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

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

// CLASS DECLARATION

/**

 * Callback interface for service consumers

 */

class MSenAlrServiceConnection

    {

    public: 

        /**

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

        * connection as a response to PreferredCarrierAvailable() callback.

        *

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

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

        * available,         

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

        */

	    virtual void MigrateToPrefferedCarrierL(TBool &aUserChoice) = 0 ;

        /**

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

        * connection as a response to NewCarrierActive() callback.

        * 

        * Earlier the client has received MigrateToPrefferedCarrierL()

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

        * newCarrierActive() callback will be invoked in order

        * to get acceptance from the application.

        *

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

        * if UserChoice is TRUE then new Carrier will be accepted

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

        */

	    virtual void NewCarrierAcceptedL(TBool &aUserChoice) = 0 ;		

    };    

#endif //  M_SEN_SERVICE_CONNNECTION_INTERFACES_H