/*

* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:   Class header for CWsfWlanIapCreator

*

*/

#ifndef C_WSFWLANIAPCREATOR_H

#define C_WSFWLANIAPCREATOR_H

//  EXTERNAL INCLUDES

#include <e32base.h>

#include <cmmanagerext.h>

#include <cmpluginwlandef.h>

//  INTERNAL INCLUDES

#include "wsfwlaninfo.h"

//  CLASS DEFINITION

/**

* Class collects various IAP creation related functions.

*

* @lib wsfapwizard.lib

* @since S60 5.0

*/

NONSHARABLE_CLASS( CWsfWlanIapCreator ): public CBase

    {

    public:

        /**

        * Factory function.

        * @since S60 5.0

        * @return Class instance

        */

        static CWsfWlanIapCreator* NewL();

        /**

        * Factory function.

        * @since S60 5.0

        * @return Class instance

        */

        static CWsfWlanIapCreator* NewLC();

        /**

        * Destructor

        * @since S60 5.0

        */

        ~CWsfWlanIapCreator();

    private:    // constructors

        /**

        * Constructor

        * @since S60 5.0

        */

        CWsfWlanIapCreator();    

        /**

        * Second-phase constructor

        * @since S60 5.0

        */

        void ConstructL();

    public:     // new methods

        /**

        * Sets the default destination for subsequent access point 

        * creation calls

        * @since S60 5.0

        * @param aDestinationId The id of the new default destination

        */

        void SetDefaultDestination( const TUint32 aDestinationId );

        /**

        * Creates an access point to wlan.

        * @since S60 5.0

        * @param aWlanInfo Contains all available data from wlan scanner. 

        *                  Note: the network name field may change if 

        *                  IAP already exists, e.g. MyWlan -> MyWlan(01). 

        *                  Also the IAP id is changed on successful creation

        * @param aPresharedKey The used key to access network

        * @param aIsHex ETrue if the key is given in hexadecimal string format.

        *               Applicable only in case of WEP authentication.

        */    

        void CreateAccessPointL( TWsfWlanInfo& aWlanInfo, 

                                 const TDesC& aPresharedKey, 

                                 const TBool aIsHex );    

    private:    // new methods

        /**

        * Creates connection method using the given WLAN parameters

        * @since S60 5.0

        * @param aWlanInfo WLAN parameters.

        *                  Note: the network name field may change if 

        *                  IAP already exists, e.g. MyWlan -> MyWlan(01)

        * @return The id of the created IAP

        */

        TUint32 CreateConnectionMethodL( TWsfWlanInfo& aWlanInfo );

        /**

        * Stores WPA data

        * @since S60 5.0

        * @param aIapId The IAP for which WPA data are to be stored

        * @param aPresharedKey WPA key string. MUST be correct as the function

        *                  DOES NOT verify its correctness!

        * @param aSecMode Security mode (to tell apart WPA-PSK/EAP)

        */    

        void StoreWPADataL( const TInt aIapId, 

                            const TDesC& aPresharedKey, 

                            const CMManager::TWlanSecMode aSecMode );

        /**

        * Stores WEP key data

        * @param S60 5.0

        * @param aIapId The IAP for which WEP data are to be stored

        * @param aWepKey WEP key string. MUST be correct as the function 

        *                  DOES NOT verify its correctness!

        * @param aIsHexWep To indicate whether the passed key is in hex format

        */

        void StoreWEPDataL( const TInt aIapId, 

                            const TDesC& aWepKey, 

                            const TBool aIsHexWep );

        /**

        * Converts an ascii sequence to hexadecimal character string

        * @since S60 5.0

        * @param aSource The ASCII string

        * @param aDest The destination for the hex string

        */

        void ConvertAsciiToHex( const TDesC8& aSource, TDes8& aDest );

        /**

        * Cleanup function for commsdat session

        * @since S60 5.0

        * @param aDbSession The commsdat session to clean up

        */

        static void RollbackCommsDat( TAny* aDbSession );

    private:    // data

        /**

        * Commsdat session object (owned)

        */

        CommsDat::CMDBSession *iDbSession;

        /**

        * Handle to the CmManager

        */

        RCmManagerExt iCmManagerExt;

        /**

        * Default destination id

        */

        TUint32 iDestinationId;

    };

#endif // C_WSFWLANIAPCREATOR_H