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 #ifndef C_WIFIPROTUICLIENTIMPL_H

    20 #define C_WIFIPROTUICLIENTIMPL_H

    21 

    22 // INCLUDES

    23 #include <e32base.h>

    24 #include <wifiprotuiclient.h>

    25 

    26 #include "wifiparams.h"

    27 #include "wifiprotsyncclient.h"

    28 

    29 // FORWARD DECLARATIONS

    30 class CCommsDatabase;

    31 class TConnectionPrefs;

    32 class CAknGlobalNote;

    33 

    34 

    35 // CLASS DECLARATION

    36 

    37 /**

    38 * Wi-Fi Protected Setup.

    39 * Implementation behind proxy class CWiFiProt.

    40 */

    41 NONSHARABLE_CLASS( CWiFiProtUiClientImpl ) : public CBase

    42     {

    43     public:

    44 

    45         /**

    46         * Two-phased constructor. Leaves on failure.

    47         * @return The constructed CConnectionUiUtilities object.

    48         */

    49         static CWiFiProtUiClientImpl* NewL();

    50 

    51         /**

    52         * Destructor.

    53         */

    54         virtual ~CWiFiProtUiClientImpl();

    55 

    56     public:

    57         /**

    58         * Starts WiFi Protected Setup sequence - async version

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

    60         * @param aConnectionNeeded not used anymore

    61         * @param aUidsReturned uids of the configured connection methods

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

    63         * process and not use 

    64         * protected setup (No Automatic Setup).

    65         */

    66         void StartWiFiProtL ( const TWlanSsid& aSSid,

    67          TBool aConnectionNeeded, RArray<TUint32>& aUidsReturned,

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

    69         

    70         /**

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

    72         * when completed

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

    74         * @param aConnectionNeeded not used anymore 

    75         * @param aUidsReturned uids of the configured connection methods

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

    77         * protected setup (No Automatic Setup).

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

    79         */

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

    81                                                  TBool aConnectionNeeded,

    82                                           RArray<TUint32>& aUidsReturned );

    83         

    84         /**

    85         * Starts WiFi Protected Setup sequence in Connection initiation mode

    86         * (WPS phase 2 implementation)

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

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

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

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

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

    92         * @param aStatus - Request status of the client       

    93         */

    94         void StartWiFiProtConnL( const TWlanSsid& aSSid,

    95                                       TWlanProtectedSetupCredentialAttribute&

    96                                         aNetworkSettings,

    97                                       WiFiProt::TWiFiReturn& aReturnValue,

    98                                       TRequestStatus& aStatus );

    99 

   100         /**

   101         * Cancels WiFi Protected Setup sequence

   102         */

   103         void CancelWiFiProt( );        

   104 

   105     private:  // Constructors

   106 

   107         /**

   108         * Constructor.

   109         */

   110         CWiFiProtUiClientImpl();

   111 

   112         /**

   113         * Second-phase constructor.

   114         */

   115         void ConstructL();

   116   

   117                                   

   118     // Data

   119     private:     

   120         // notifier client

   121         RWiFiProtSession iNotif; 

   122         // Synchronously callable client

   123         CWiFiProtSyncClient* iWiFiProtSyncClient;

   124     };

   125 

   126 

   127 #endif  // C_WIFIPROTUICLIENTIMPL_H

   128 

   129 // End of File

   130