|
1 /* |
|
2 * Copyright (c) 2002 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 "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: |
|
15 * Declares the main handler, CConnectionUiUtilities and public API for the |
|
16 * Connection Ui Utilities. |
|
17 * |
|
18 */ |
|
19 |
|
20 |
|
21 #ifndef CONNECTIONUIUTILITIES_H |
|
22 #define CONNECTIONUIUTILITIES_H |
|
23 |
|
24 // INCLUDES |
|
25 |
|
26 #include <e32base.h> |
|
27 #include <wlanmgmtcommon.h> |
|
28 |
|
29 |
|
30 // FORWARD DECLARATIONS |
|
31 class CConnectionUiUtilitiesImpl; |
|
32 class TConnectionPrefs; |
|
33 |
|
34 |
|
35 // CONSTANT DECLARATIONS |
|
36 |
|
37 |
|
38 // TYPE DECLARATIONS |
|
39 |
|
40 enum TCuuAlwaysAskResults |
|
41 { |
|
42 ECuuAlwaysAsk = 0, |
|
43 ECuuUserDefined |
|
44 }; |
|
45 |
|
46 |
|
47 enum TMsgQueryLinkedResults |
|
48 { |
|
49 EMsgQueryCancelled = 0, // Message query was cancelled |
|
50 EMsgQueryAutomatically, |
|
51 EMsgQueryThisTime |
|
52 }; |
|
53 |
|
54 |
|
55 // CLASS DECLARATION |
|
56 /* |
|
57 * Connection Ui Utilities, it is a set of Miscellaneous networking related |
|
58 * ui functions |
|
59 * Proxy around the real implementation in CConnectionUiUtilitiesUiImpl. |
|
60 * No details of the actual data are exposed. |
|
61 */ |
|
62 NONSHARABLE_CLASS( CConnectionUiUtilities ) : public CBase |
|
63 { |
|
64 |
|
65 public: // Constructors and destructor |
|
66 |
|
67 /** |
|
68 * Two-phased constructor. Leaves on failure. |
|
69 * @return The constructed CConnectionUiUtilities object. |
|
70 */ |
|
71 IMPORT_C static CConnectionUiUtilities* NewL(); |
|
72 |
|
73 |
|
74 /** |
|
75 * Destructor. |
|
76 */ |
|
77 IMPORT_C ~CConnectionUiUtilities(); |
|
78 |
|
79 |
|
80 public: // New methods |
|
81 |
|
82 /** |
|
83 * @param aResult contains ECuuAlwaysAsk if always ask radio button |
|
84 * was selected, and ECuuUserDefined if user defined |
|
85 * radio button was selected by user |
|
86 * It acts also as input parameter to default this setting. |
|
87 * @return ETrue if OK Soft key was pressed, |
|
88 * EFalse if Cancel Soft key was selected on the dialog. |
|
89 */ |
|
90 IMPORT_C TBool AlwaysAskPageL( TCuuAlwaysAskResults& aResult ); |
|
91 |
|
92 /** |
|
93 * @param aIAPId specifies the IAP to be excluded from the list |
|
94 * @param aIAPId gives back the iapid of selected connection |
|
95 * @param aPrefs Specifies the rank and desired direction and bearer |
|
96 * of the connections will appear in the dialog |
|
97 * @return ETrue if Select Soft key was pressed, |
|
98 * EFalse if Cancel Soft key was selected on the dialog. |
|
99 */ |
|
100 IMPORT_C TBool ChangeConnectionL( TUint32& aIAPId, |
|
101 TConnectionPrefs aPrefs ); |
|
102 /** |
|
103 * Pops up an information note, about connection is changed to |
|
104 * the given accespont |
|
105 * @param aIAPId The id of access point which has been selected. |
|
106 */ |
|
107 IMPORT_C void ShowConnectionChangedNoteL( const TUint32& aIAPId ); |
|
108 |
|
109 /** |
|
110 * Pops up discreet popup indicating that connection is being |
|
111 * established to the given access point. |
|
112 * This method should only be used from the MPM in order to provide |
|
113 * a consistent popup behavior across the platform. |
|
114 * @param aIAPId The id of the access point. |
|
115 * @param aConnectionActive is connection already active. |
|
116 */ |
|
117 IMPORT_C void ConnectingViaDiscreetPopup( const TUint32& aIAPId, TBool aConnectionAlreadyActive ); |
|
118 |
|
119 /** |
|
120 * Pops up a discreet popup indicating a connection error. |
|
121 * Only appropriate error codes show the popup, otherwise |
|
122 * (such as with general errors) the popup is not shown. |
|
123 * This method should only be used from the MPM in order to provide |
|
124 * a consistent popup behavior across the platform. |
|
125 * @param aErrCode Symbian error code. |
|
126 */ |
|
127 IMPORT_C void ConnectionErrorDiscreetPopup( const TInt& aErrorCode ); |
|
128 |
|
129 /** |
|
130 * Notifier. Search available WLAN networks, and user can select one of |
|
131 * them |
|
132 * @param aSSID the id of selected wlan network |
|
133 * @return ETrue if user selected one of networks, EFalse if an error |
|
134 * is occured or user does not select a network. |
|
135 */ |
|
136 IMPORT_C TBool SearchWLANNetwork( TWlanSsid& aSSID ); |
|
137 |
|
138 /** |
|
139 * Cancel SearchWLANNetwork |
|
140 */ |
|
141 IMPORT_C void CancelSearchWLANNetwork(); |
|
142 |
|
143 |
|
144 /** |
|
145 * Notifier. Shows a query, "Do you want to create a WLAN connection in |
|
146 * Off-line mode?" |
|
147 * @return ETrue if user select Yes, EFalse otherwise |
|
148 */ |
|
149 IMPORT_C TBool OffLineWlanNote(); |
|
150 |
|
151 /** |
|
152 * Cancel OffLineWlan Note |
|
153 */ |
|
154 IMPORT_C void CancelOffLineWlanNote(); |
|
155 |
|
156 /** |
|
157 * Notifier. Pops up an information note: |
|
158 * "Operation not possible in Off-line mode" |
|
159 */ |
|
160 IMPORT_C void OffLineWlanDisabledNote(); |
|
161 |
|
162 /** |
|
163 * @deprecated |
|
164 * |
|
165 * Use TBool EasyWepDlg( TDes* aKey, TBool& aHex )! |
|
166 * |
|
167 * Notifier. Shows a data query, "Enter WEP key for WLAN" |
|
168 * @param aKey Key entered by user. Default value can be passed |
|
169 * @return ETrue if user select OK, EFalse otherwise |
|
170 */ |
|
171 IMPORT_C TBool EasyWepDlg( TDes* aKey ); |
|
172 |
|
173 /** |
|
174 * Cancel Easy Wep dialog |
|
175 */ |
|
176 IMPORT_C void CancelEasyWepDlg(); |
|
177 |
|
178 /** |
|
179 * Notifier. Shows a data query, "Enter pre-shared key for WLAN" |
|
180 * @param aKey Key entered by user. Default value can be passed |
|
181 * @return ETrue if user select OK, EFalse otherwise |
|
182 */ |
|
183 IMPORT_C TBool EasyWpaDlg( TDes* aKey ); |
|
184 |
|
185 /** |
|
186 * Notifier. Shows a data query, "Enter pre-shared key for WLAN" |
|
187 * Async version |
|
188 * @param aStatus caller's TRequestStatus to handle asynchronous call. |
|
189 * @param aKey Key entered by user. Default value can be passed |
|
190 */ |
|
191 IMPORT_C void EasyWpaDlg( TRequestStatus& aStatus, TDes* aKey ); |
|
192 |
|
193 /** |
|
194 * Cancel Easy Wpa dialog |
|
195 */ |
|
196 IMPORT_C void CancelEasyWpaDlg(); |
|
197 |
|
198 /** |
|
199 * Notifier. Seatrch available WLAN networks, and user can select one |
|
200 * of them |
|
201 * @param aSSID the id of selected wlan network |
|
202 * @param aConnectionMode connection mode of selected wlan network |
|
203 * @param aSecurityMode security mode of selected wlan network |
|
204 * @return ETrue if user selected one of networks, EFalse if an error |
|
205 * is occured or user does not select a network. |
|
206 */ |
|
207 IMPORT_C TBool SearchWLANNetwork |
|
208 ( |
|
209 TWlanSsid& aSSID, |
|
210 TWlanConnectionMode& aConnectionMode, |
|
211 TWlanConnectionSecurityMode& aSecurityMode |
|
212 ); |
|
213 |
|
214 /** |
|
215 * Notifier. Search available WLAN networks, and user can select one |
|
216 * of them |
|
217 * @param aSSID the id of selected wlan network |
|
218 * @param aConnectionMode connection mode of selected wlan network |
|
219 * @param aExtendedSecurityMode extended security mode of selected wlan network |
|
220 * @return ETrue if user selected one of networks, EFalse if an error |
|
221 * is occured or user does not select a network. |
|
222 */ |
|
223 IMPORT_C TBool SearchWLANNetwork |
|
224 ( |
|
225 TWlanSsid& aSSID, |
|
226 TWlanConnectionMode& aConnectionMode, |
|
227 TWlanConnectionExtentedSecurityMode& aExtendedSecurityMode |
|
228 ); |
|
229 |
|
230 /** |
|
231 * Notifier. Shows a data query, "Enter WEP key for WLAN" |
|
232 * @param aKey Key entered by user. Default value can be passed |
|
233 * @param aHex Returns ETrue if user entered hexadecimal key, |
|
234 * EFalse, if user entered ASCII key |
|
235 * @return ETrue if user pressed OK, EFalse otherwise |
|
236 */ |
|
237 IMPORT_C TBool EasyWepDlg( TDes* aKey, TBool& aHex ); |
|
238 |
|
239 /** |
|
240 * Notifier. Shows a data query, "Enter WEP key for WLAN" |
|
241 * Async version |
|
242 * @param aStatus caller's TRequestStatus to handle asynchronous call. |
|
243 * @param aKey Key entered by user. Default value can be passed |
|
244 * @param aHex Returns ETrue if user entered hexadecimal key, |
|
245 * EFalse, if user entered ASCII key |
|
246 */ |
|
247 IMPORT_C void EasyWepDlg( TRequestStatus& aStatus, TDes* aKey, TBool& aHex ); |
|
248 |
|
249 /** |
|
250 * Notifier. Pops up an information note: |
|
251 * "Selected WLAN network has no coverage" |
|
252 */ |
|
253 IMPORT_C void WLANNetworkUnavailableNote(); |
|
254 |
|
255 /** |
|
256 * Notifier. Search available WLAN networks, and user can select one of |
|
257 * them. Totally synchronous version, to be used from Engines, not from |
|
258 * UIs |
|
259 * @param aSSID the id of selected wlan network |
|
260 * @param aConnectionMode connection mode of selected wlan network |
|
261 * @param aSecurityMode security mode of selected wlan network |
|
262 * @return ETrue if user selected one of networks, EFalse if an error |
|
263 * is occured or user does not select a network. |
|
264 */ |
|
265 IMPORT_C TBool SearchWLANNetworkSync |
|
266 ( |
|
267 TWlanSsid& aSSID, |
|
268 TWlanConnectionMode& aConnectionMode, |
|
269 TWlanConnectionSecurityMode& aSecurityMode |
|
270 ); |
|
271 |
|
272 /** |
|
273 * Notifier. Search available WLAN networks, and user can select one of |
|
274 * them. Totally asynchronous version, to be used from Engines, not |
|
275 * from UIs |
|
276 * @param aStatus status object of notifier |
|
277 * @param aSSID the id of selected wlan network |
|
278 * @param aConnectionMode connection mode of selected wlan network |
|
279 * @param aSecurityMode security mode of selected wlan network |
|
280 * @return |
|
281 */ |
|
282 IMPORT_C void SearchWLANNetworkAsync( TRequestStatus& aStatus, |
|
283 TWlanSsid& aSSID, |
|
284 TWlanConnectionMode& aConnectionMode, |
|
285 TWlanConnectionSecurityMode& aSecurityMode ); |
|
286 |
|
287 /** |
|
288 * Notifier. Search available WLAN networks, and user can select one of |
|
289 * them. Totally asynchronous version, to be used from Engines, not |
|
290 * from UIs |
|
291 * @param aStatus status object of notifier |
|
292 * @param aSSID the id of selected wlan network |
|
293 * @param aConnectionMode connection mode of selected wlan network |
|
294 * @param aExtendedSecurityMode extended security mode of selected wlan network |
|
295 * @return |
|
296 */ |
|
297 IMPORT_C void SearchWLANNetworkAsync( TRequestStatus& aStatus, |
|
298 TWlanSsid& aSSID, |
|
299 TWlanConnectionMode& aConnectionMode, |
|
300 TWlanConnectionExtentedSecurityMode& aExtendedSecurityMode ); |
|
301 |
|
302 /** |
|
303 * DEPRECATED, PLEASE USE ASYNC VERSION! |
|
304 * Confirmation note is used after the connection has been successfully |
|
305 * established via destination and connection method. |
|
306 * @param aDestId Id of used destination. |
|
307 * @param aConnMId Id of used connection method. |
|
308 */ |
|
309 IMPORT_C void ConnectedViaDestAndConnMethodNote( const TUint32 aDestId, |
|
310 const TUint32 aConnMId ); |
|
311 |
|
312 /** |
|
313 * Confirmation note is used after the connection has been successfully |
|
314 * established via destination and connection method. |
|
315 * @param aDestId Id of used destination. |
|
316 * @param aConnMId Id of used connection method. |
|
317 * @param aStatus caller's TRequestStatus to handle asynchronous call. |
|
318 */ |
|
319 void ConnectedViaDestAndConnMethodNote( const TUint32 aDestId, |
|
320 const TUint32 aConnMId, |
|
321 TRequestStatus& aStatus ); |
|
322 |
|
323 /** |
|
324 * Cancel ConnectedViaDestAndConnMethodNote notifier. |
|
325 */ |
|
326 IMPORT_C void CancelConnectedViaDestAndConnMethodNote(); |
|
327 |
|
328 /** |
|
329 * @deprecated |
|
330 * |
|
331 * Use void ReconnectToMethodQuery( const TUint32 aDestId, |
|
332 * const TUint32 aConnMId, |
|
333 * const TBool aNextBestExists, |
|
334 * TMsgQueryLinkedResults& aResult, |
|
335 * TRequestStatus& aStatus ); |
|
336 * |
|
337 * Confirmation query is used when current method is lost and |
|
338 * connection is going to be established via another lower priority |
|
339 * method. |
|
340 * @param aConnMId Id of used connection method. |
|
341 * @param aResult Result of user selection, ETrue if user accepted |
|
342 * roaming, to less preferred method, EFlase otherwise |
|
343 * @param aStatus Status object of notifier. |
|
344 */ |
|
345 IMPORT_C void ReconnectToMethodQuery( const TUint32 aConnMId, |
|
346 TBool& aResult, |
|
347 TRequestStatus& aStatus ); |
|
348 /** |
|
349 * Cancel ReconnectToMethodQuery notifier. |
|
350 */ |
|
351 IMPORT_C void CancelReconnectToMethodQuery(); |
|
352 |
|
353 /** |
|
354 * @deprecated |
|
355 * |
|
356 * Use void RoamingToMorePrefMethodQuery( const TUint32 aDestId, |
|
357 * const TUint32 aConnMId, |
|
358 * const TBool aNextBestExists, |
|
359 * TMsgQueryLinkedResults& aResult, |
|
360 * TRequestStatus& aStatus ); |
|
361 * |
|
362 * Confirmation query is used when more preferred method becomes |
|
363 * available |
|
364 * @param aConnMId Id of used connection method. |
|
365 * @param aResult Result of user selection, ETrue if user accepted |
|
366 * roaming, to more preferred method, EFlase otherwise |
|
367 * @param aStatus Status object of notifier. |
|
368 */ |
|
369 IMPORT_C void RoamingToMorePrefMethodQuery( const TUint32 aConnMId, |
|
370 TBool& aResult, |
|
371 TRequestStatus& aStatus ); |
|
372 /** |
|
373 * Cancel RoamingToMorePrefMethodQuery notifier. |
|
374 */ |
|
375 IMPORT_C void CancelRoamingToMorePrefMethodQuery(); |
|
376 |
|
377 /** |
|
378 * Information note is used when "Automatically" roaming is enabled. The |
|
379 * actual connection establishment take places in the background |
|
380 * (no wait note). |
|
381 * @param aConnMId Id of used connection method. |
|
382 */ |
|
383 IMPORT_C void ChangingConnectionToNote( const TUint32 aConnMId ); |
|
384 |
|
385 /** |
|
386 * Information note is used when "Automatically" roaming is enabled. The |
|
387 * actual connection establishment take places in the background |
|
388 * (no wait note). This is the asynchronous version of the previous one |
|
389 * @param aConnMId Id of used connection method. |
|
390 * @param aStatus Status object of the notifier |
|
391 */ |
|
392 IMPORT_C void ChangingConnectionToNote( const TUint32 aConnMId, |
|
393 TRequestStatus& aStatus ); |
|
394 |
|
395 /** |
|
396 * Cancel ChangingConnectionToNote notifier. |
|
397 */ |
|
398 IMPORT_C void CancelChangingConnectionToNote(); |
|
399 |
|
400 /** |
|
401 * @deprecated |
|
402 * |
|
403 * Use void ConfirmMethodUsageQuery( const TUint32 aDestId, |
|
404 * const TUint32 aConnMId, |
|
405 * const TBool aNextBestExists, |
|
406 * TMsgQueryLinkedResults& aResult, |
|
407 * TRequestStatus& aStatus ); |
|
408 * |
|
409 * Notifier. Shows a query, "Connect to\n '%0U' via\n '%1U'?" |
|
410 * @param aDestId Id of used destination. |
|
411 * @param aConnMId Id of used connection method. |
|
412 * @param aResult Result of user selection, ETrue if user accepted |
|
413 * query, EFalse otherwise |
|
414 * @param aStatus Status object of notifier. |
|
415 */ |
|
416 IMPORT_C void ConfirmMethodUsageQuery( const TUint32 aDestId, |
|
417 const TUint32 aConnMId, |
|
418 TBool& aResult, |
|
419 TRequestStatus& aStatus ); |
|
420 |
|
421 /** |
|
422 * Cancel ConfirmMethodUsageQuery |
|
423 */ |
|
424 IMPORT_C void CancelConfirmMethodUsageQuery(); |
|
425 |
|
426 /** |
|
427 * DEPRECATED, PLEASE USE ASYNC VERSION! |
|
428 * Confirmation note is used after the connection has been successfully |
|
429 * established via a connection method. |
|
430 * @param aConnMId Id of used connection method. |
|
431 */ |
|
432 IMPORT_C void ConnectedViaConnMethodNote( const TUint32 aConnMId ); |
|
433 |
|
434 /** |
|
435 * Confirmation note is used after the connection has been successfully |
|
436 * established via a connection method. |
|
437 * @param aConnMId Id of used connection method. |
|
438 * @param aStatus caller's TRequestStatus to handle asynchronous call. |
|
439 */ |
|
440 void ConnectedViaConnMethodNote( const TUint32 aConnMId, |
|
441 TRequestStatus& aStatus ); |
|
442 |
|
443 /** |
|
444 * Cancel ConnectedViaConnMethodNote notifier. |
|
445 */ |
|
446 IMPORT_C void CancelConnectedViaConnMethodNote(); |
|
447 |
|
448 /** |
|
449 * Confirmation query is used when current method is lost and |
|
450 * connection is going to be established via another lower priority |
|
451 * method. |
|
452 * @param aDestId Id of used destination. |
|
453 * @param aConnMId Id of used connection method. |
|
454 * @param aNextBestExists ETrue if there is another available CM inside |
|
455 * the destination that could be used |
|
456 * @param aResult Result of user selection |
|
457 * @param aStatus Status object of notifier. |
|
458 */ |
|
459 IMPORT_C void ReconnectToMethodQuery( const TUint32 aDestId, |
|
460 const TUint32 aConnMId, |
|
461 const TBool aNextBestExists, |
|
462 TMsgQueryLinkedResults& aResult, |
|
463 TRequestStatus& aStatus ); |
|
464 |
|
465 /** |
|
466 * Confirmation query is used when more preferred method becomes |
|
467 * available |
|
468 * @param aDestId Id of used destination. |
|
469 * @param aConnMId Id of used connection method. |
|
470 * @param aNextBestExists ETrue if there is another available CM inside |
|
471 * the destination that could be used |
|
472 * @param aResult Result of user selection |
|
473 * @param aStatus Status object of notifier. |
|
474 */ |
|
475 IMPORT_C void RoamingToMorePrefMethodQuery( const TUint32 aDestId, |
|
476 const TUint32 aConnMId, |
|
477 const TBool aNextBestExists, |
|
478 TMsgQueryLinkedResults& aResult, |
|
479 TRequestStatus& aStatus ); |
|
480 |
|
481 /** |
|
482 * Notifier. Shows a query, "Connect to\n '%0U' via\n '%1U'?" |
|
483 * @param aResult Result of user selection |
|
484 * @param aHomeNetwork Home or foreign network. |
|
485 * @param aStatus Status object of notifier |
|
486 */ |
|
487 IMPORT_C void ConfirmMethodUsageQuery( TMsgQueryLinkedResults& aResult, |
|
488 const TBool aHomeNetwork, |
|
489 TRequestStatus& aStatus ); |
|
490 |
|
491 |
|
492 /** |
|
493 * Notifier. Shows a query, "Do you want to create a WLAN connection in |
|
494 * Off-line mode?" |
|
495 * @param aStatus Status object of notifier. |
|
496 */ |
|
497 IMPORT_C void OffLineWlanNote( TRequestStatus& aStatus ); |
|
498 |
|
499 /** |
|
500 * Notifier that displays "Power save test" information note. |
|
501 * @param aDisable On completion, contains ETrue if user wants to disable |
|
502 * the note in the future. EFalse otherwise. |
|
503 * @param aStatus KErrNone if successful, a system-wide error code if not. |
|
504 */ |
|
505 IMPORT_C void WlanPowerSaveTestNote( TBool& aDisable, |
|
506 TRequestStatus& aStatus ); |
|
507 |
|
508 /** |
|
509 * Cancel WlanPowerSaveTestNote notifier. |
|
510 */ |
|
511 IMPORT_C void CancelWlanPowerSaveTestNote(); |
|
512 |
|
513 /** |
|
514 * Notifier. Shows a data query prompting for WAPI pre-shared key. |
|
515 * @param aKey Key entered by user. Default value can be passed |
|
516 * @return ETrue if user select OK, EFalse otherwise |
|
517 */ |
|
518 IMPORT_C TBool EasyWapiDlg( TDes* aKey ); |
|
519 |
|
520 /** |
|
521 * Notifier. Pops up an information note: |
|
522 * "No WLAN networks are available at the moment. Connection not available." |
|
523 */ |
|
524 IMPORT_C void NoWLANNetworksAvailableNote(); |
|
525 |
|
526 /** |
|
527 * Notifier. Search available WLAN networks, and user can select one of |
|
528 * them. Totally asynchronous version, to be used from Engines, not |
|
529 * from UIs |
|
530 * @param aStatus status object of notifier |
|
531 * @param aSSID the id of selected wlan network |
|
532 * @param aConnectionMode connection mode of selected wlan network |
|
533 * @param aSecurityMode security mode of selected wlan network, |
|
534 * @param aProtectedSetupSupported if the wlan supports Protected Setup |
|
535 * @return |
|
536 */ |
|
537 IMPORT_C void SearchWLANNetworkAsync( TRequestStatus& aStatus, |
|
538 TWlanSsid& aSSID, |
|
539 TWlanConnectionMode& aConnectionMode, |
|
540 TWlanConnectionSecurityMode& aSecurityMode, |
|
541 TBool& aProtectedSetupSupported ); |
|
542 |
|
543 /** |
|
544 * Notifier. Search available WLAN networks, and user can select one of |
|
545 * them. Totally asynchronous version, to be used from Engines, not |
|
546 * from UIs |
|
547 * @param aStatus status object of notifier |
|
548 * @param aSSID the id of selected wlan network |
|
549 * @param aConnectionMode connection mode of selected wlan network |
|
550 * @param aExtendedSecurityMode extended security mode of selected wlan network, |
|
551 * @param aProtectedSetupSupported if the wlan supports Protected Setup |
|
552 * @return |
|
553 */ |
|
554 IMPORT_C void SearchWLANNetworkAsync( TRequestStatus& aStatus, |
|
555 TWlanSsid& aSSID, |
|
556 TWlanConnectionMode& aConnectionMode, |
|
557 TWlanConnectionExtentedSecurityMode& aExtendedSecurityMode, |
|
558 TBool& aProtectedSetupSupported ); |
|
559 |
|
560 /** |
|
561 * Notifier. Search available WLAN networks, and user can select one of |
|
562 * them. Totally synchronous version, to be used from Engines, not from |
|
563 * UIs |
|
564 * @param aSSID the id of selected wlan network |
|
565 * @param aConnectionMode connection mode of selected wlan network |
|
566 * @param aSecurityMode security mode of selected wlan network |
|
567 * @param aProtectedSetupSupported if the wlan supports Protected Setup |
|
568 * @return ETrue if user selected one of networks, EFalse if an error |
|
569 * is occured or user does not select a network. |
|
570 */ |
|
571 IMPORT_C TBool SearchWLANNetworkSync( TWlanSsid& aSSID, |
|
572 TWlanConnectionMode& aConnectionMode, |
|
573 TWlanConnectionSecurityMode& aSecurityMode, |
|
574 TBool& aProtectedSetupSupported ); |
|
575 |
|
576 /** |
|
577 * Notifier. Seatrch available WLAN networks, and user can select one |
|
578 * of them |
|
579 * @param aSSID the id of selected wlan network |
|
580 * @param aConnectionMode connection mode of selected wlan network |
|
581 * @param aSecurityMode security mode of selected wlan network |
|
582 * @param aProtectedSetupSupported if the wlan supports Protected Setup |
|
583 * @return ETrue if user selected one of networks, EFalse if an error |
|
584 * is occured or user does not select a network. |
|
585 */ |
|
586 IMPORT_C TBool SearchWLANNetwork( TWlanSsid& aSSID, |
|
587 TWlanConnectionMode& aConnectionMode, |
|
588 TWlanConnectionSecurityMode& aSecurityMode, |
|
589 TBool& aProtectedSetupSupported ); |
|
590 |
|
591 /** |
|
592 * Notifier. Search available WLAN networks, and user can select one |
|
593 * of them |
|
594 * @param aSSID the id of selected wlan network |
|
595 * @param aConnectionMode connection mode of selected wlan network |
|
596 * @param aExtendedSecurityMode extended security mode of selected wlan network |
|
597 * @param aProtectedSetupSupported if the wlan supports Protected Setup |
|
598 * @return ETrue if user selected one of networks, EFalse if an error |
|
599 * is occured or user does not select a network. |
|
600 */ |
|
601 IMPORT_C TBool SearchWLANNetwork( TWlanSsid& aSSID, |
|
602 TWlanConnectionMode& aConnectionMode, |
|
603 TWlanConnectionExtentedSecurityMode& aExtendedSecurityMode, |
|
604 TBool& aProtectedSetupSupported ); |
|
605 |
|
606 |
|
607 private: // Data |
|
608 |
|
609 CConnectionUiUtilitiesImpl* iImpl; ///< Implementation. Owned. |
|
610 |
|
611 }; |
|
612 |
|
613 #endif |
|
614 |
|
615 // End of File |