1 /*

     2 * Copyright (c) 2001-2009 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: Declaration of class CWiFiProtUiClientImpl.  

    15 *

    16 */

    17 

    18 /*

    19 * %version: tr1cfwln#7 %

    20 */

    21 

    22 #ifndef C_WIFIPROTUICLIENTIMPL_H

    23 #define C_WIFIPROTUICLIENTIMPL_H

    24 

    25 // INCLUDES

    26 #include <e32base.h>

    27 #include <wifiprotuiclient.h>

    28 

    29 #include "wifiparams.h"

    30 #include "wifiprotsyncclient.h"

    31 

    32 // FORWARD DECLARATIONS

    33 class CCommsDatabase;

    34 class TConnectionPrefs;

    35 class CAknGlobalNote;

    36 

    37 

    38 // CLASS DECLARATION

    39 

    40 /**

    41 * Wi-Fi Protected Setup.

    42 * Implementation behind proxy class CWiFiProt.

    43 */

    44 NONSHARABLE_CLASS( CWiFiProtUiClientImpl ) : public CBase

    45     {

    46     public:

    47 

    48         /**

    49         * Two-phased constructor. Leaves on failure.

    50         * @return The constructed CConnectionUiUtilities object.

    51         */

    52         static CWiFiProtUiClientImpl* NewL();

    53 

    54         /**

    55         * Destructor.

    56         */

    57         virtual ~CWiFiProtUiClientImpl();

    58 

    59     public:

    60         /**

    61         * Starts WiFi Protected Setup sequence - async version

    62         * @param aSSid contains SSid of the network we want to configure 

    63         * @param aConnectionNeeded not used anymore

    64         * @param aUidsReturned uids of the configured connection methods

    65         * @param aReturnValue - possible return values are ok, cancel

    66         * process and not use 

    67         * protected setup (No Automatic Setup).

    68         */

    69         void StartWiFiProtL ( const TWlanSsid& aSSid,

    70          TBool aConnectionNeeded, RArray<TUint32>& aUidsReturned,

    71           WiFiProt::TWiFiReturn& aReturnValue, TRequestStatus& aStatus );

    72         

    73         /**

    74         * Starts WiFi Protected Setup sequence - sync version, returns

    75         * when completed

    76         * @param aSSid contains SSid of the network we want to configure 

    77         * @param aConnectionNeeded not used anymore 

    78         * @param aUidsReturned uids of the configured connection methods

    79         * @return  possible return values are ok, cancel process and not use 

    80         * protected setup (No Automatic Setup).

    81         * We can return a value since the call is sychronous.

    82         */

    83         WiFiProt::TWiFiReturn StartWiFiProtSyncL( const TWlanSsid& aSSid,

    84                                                  TBool aConnectionNeeded,

    85                                           RArray<TUint32>& aUidsReturned );

    86         

    87         /**

    88         * Starts WiFi Protected Setup sequence in Connection initiation mode

    89         * (WPS phase 2 implementation)

    90         * @param aSSid contains SSid of the network we want to configure 

    91         * @param aNetworkSettings configuration settings of the network to use

    92         * for the connection (returned as the result of Protected Setup)      

    93         * @param aReturnValue - possible return values are ok, cancel

    94         * process and not use protected setup (No Automatic Setup).

    95         * @param aStatus - Request status of the client       

    96         */

    97         void StartWiFiProtConnL( const TWlanSsid& aSSid,

    98                                       TWlanProtectedSetupCredentialAttribute&

    99                                         aNetworkSettings,

   100                                       WiFiProt::TWiFiReturn& aReturnValue,

   101                                       TRequestStatus& aStatus );

   102 

   103         /**

   104         * Cancels WiFi Protected Setup sequence

   105         */

   106         void CancelWiFiProt( );        

   107 

   108     private:  // Constructors

   109 

   110         /**

   111         * Constructor.

   112         */

   113         CWiFiProtUiClientImpl();

   114 

   115         /**

   116         * Second-phase constructor.

   117         */

   118         void ConstructL();

   119   

   120                                   

   121     // Data

   122     private:     

   123         // notifier client

   124         RWiFiProtSession iNotif; 

   125         // Synchronously callable client

   126         CWiFiProtSyncClient* iWiFiProtSyncClient;

   127     };

   128 

   129 

   130 #endif  // C_WIFIPROTUICLIENTIMPL_H

   131 

   132 // End of File

   133