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__ |
|