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