1 /*

     2 * Copyright (c) 2006 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 the License "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:    Interface for network event handling*

    15 */

    16 

    17 

    18 #ifndef _M_CVCX_CONUTILENGINEOBS_H__

    19 #define _M_CVCX_CONUTILENGINEOBS_H__

    20 

    21 

    22 // CLASS DECLARATION

    23 /**

    24 * Interface for the clients of vcxconnectionutility to receive and react

    25 * for iap changes and roaming. 

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

    27 * vcxconnectionutility always excepts client to allow roaming.

    28 * 

    29 */

    30 

    31 class MConnUtilEngineObserver

    32 

    33     {

    34     public:

    35 

    36          /**

    37          * This method is called by the vcxconnectionutility when 

    38          * it has received a notification about the availability of

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

    40          * when WLAN defined in the corresponding destination becomes

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

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

    43          * being used.

    44          *

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

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

    47          * iap is not changed.

    48          *

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

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

    51          *

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

    53          *

    54          */

    55         virtual TBool RequestIsRoamingAllowedL() = 0;

    56         

    57         /**

    58          * This method is called by the vcxconnectionutility when 

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

    60          * 

    61          * Connection lost: this happens when for example WLAN carrier 

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

    63          * connection is closed by some other application.

    64          *

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

    66          * vcxconnectionutility notifies about new iap is ready to use

    67          *

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

    69          * iap id by calling CVcxConnectionUtility::GetIap-

    70          *

    71          *

    72          */

    73         virtual void  IapChangedL() = 0;

    74     };

    75 

    76 #endif // _M_CVCX_CONUTILENGINEOBS_H__