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 // Deprecation warning

    22 #warning This header file has been deprecated. Will be removed in one of the next SDK releases.

    23 

    24 

    25 // CLASS DECLARATION

    26 /**

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

    28 * for iap changes and roaming. 

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

    30 * vcxconnectionutility always excepts client to allow roaming.

    31 * 

    32 */

    33 

    34 class MConnUtilEngineObserver

    35 

    36     {

    37     public:

    38 

    39          /**

    40          * This method is called by the vcxconnectionutility when 

    41          * it has received a notification about the availability of

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

    43          * when WLAN defined in the corresponding destination becomes

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

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

    46          * being used.

    47          *

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

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

    50          * iap is not changed.

    51          *

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

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

    54          *

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

    56          *

    57          */

    58         virtual TBool RequestIsRoamingAllowedL() = 0;

    59         

    60         /**

    61          * This method is called by the vcxconnectionutility when 

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

    63          * 

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

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

    66          * connection is closed by some other application.

    67          *

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

    69          * vcxconnectionutility notifies about new iap is ready to use

    70          *

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

    72          * iap id by calling CVcxConnectionUtility::GetIap-

    73          *

    74          *

    75          */

    76         virtual void  IapChangedL() = 0;

    77     };

    78 

    79 #endif // _M_CVCX_CONUTILENGINEOBS_H__