/*

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

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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:    Interface for network event handling*

*/

#ifndef _M_CVCX_CONUTILENGINEOBS_H__

#define _M_CVCX_CONUTILENGINEOBS_H__

// CLASS DECLARATION

/**

* Interface for the clients of vcxconnectionutility to receive and react

* for iap changes and roaming. 

* It is not required for a client to implement this interface. In that case

* vcxconnectionutility always excepts client to allow roaming.

* 

*/

class MConnUtilEngineObserver

    {

    public:

         /**

         * This method is called by the vcxconnectionutility when 

         * it has received a notification about the availability of

         * "better" iaps in the network. This can happen  

         * when WLAN defined in the corresponding destination becomes

         * available or when WLAN carrier is lost and there is a defined

         * 3G/gprs iap (or another available WLAN) in the destination

         * being used.

         *

         * Client does not have to accept the changing of the iap. If the client 

         * returns EFalse notifying it does not want to roam, then the 

         * iap is not changed.

         *

         * This however can result in disconnecting, if the old iap is 

         * no longer available, as happens when WLAN carrier is lost

         *

         * @return TBool  ETrue: roaming accepted, EFalse: Roaming not accepted

         *

         */

        virtual TBool RequestIsRoamingAllowedL() = 0;

        /**

         * This method is called by the vcxconnectionutility when 

         * there have been some changes in the iap currently using:

         * 

         * Connection lost: this happens when for example WLAN carrier 

         * is lost and there is no other iap to use or when the corresponding

         * connection is closed by some other application.

         *

         * Iap change by the roaming: if the client has accepted roaming,

         * vcxconnectionutility notifies about new iap is ready to use

         *

         * When client is being called by this method, it can request an

         * iap id by calling CVcxConnectionUtility::GetIap-

         *

         *

         */

        virtual void  IapChangedL() = 0;

    };

#endif // _M_CVCX_CONUTILENGINEOBS_H__