/*
* Copyright (c) 2006 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:  Declaration of WLAN Coverage Check class
*
*/

#ifndef CMWLANCOVERAGECHECK_H
#define CMWLANCOVERAGECHECK_H

// INCLUDES
#include <e32base.h>
#include <cmpluginwlandef.h>


// FORWARD DECLARATION
class CCmPluginWlanDataArray;
 
using namespace CMManager;

/**
 *  WLAN Coverage Check
 *
 *  ?more_complete_description
 *
 *  @since S60 3.2
 */
class CCmWlanCoverageCheck : public CActive
    {
    enum EWlanCoverageState
        {
        EServiceStatus,
        EScanning,
        EDone,                        
        };
        
    public:
    
        CCmWlanCoverageCheck();
        ~CCmWlanCoverageCheck();
        
        TInt GetCoverageL();

        TBool ScanForPromptedSsidL( TWlanSsid aEnteredSsid, TBool aBroadcast,
                                TWlanNetMode& aNetworkMode,
                                TWlanConnectionExtentedSecurityMode& aSecurityMode,
                                TBool& aProtectedSetupSupported );

        /**
        * Returns whether the passed ssid and length results in a hidden or 
        * a non-hidden ssid.
        *
        * @since S60 3.2
        * @param aSsidLength The length of the ssid
        * @param aSsid The ssid
        * @return ETrue if the ssid is hidden.
        */
        TBool IsHiddenSsid( TUint aSsidLength, const TUint8* aSsid ) const;
        
        /**
        * Adds the passed WLAN network data to the container array
        * if it is not already there, and sets the highest signal 
        * strength if it is already in the array.
        *
        * @since S60 3.2
        * @param aArray The array to be checked
        * @param aRXLevel The signal level of this WLAN
        * @param aNetworkName The network name (SSID) of this WLAN.
        */
        void AddToArrayIfNeededL( 
                            CCmPluginWlanDataArray& aArray, 
                            TInt aRXLevel, 
                            TDesC& aNetworkName ) const;
                
                
    protected:  // from CActive
    
        virtual void DoCancel();
        virtual void RunL();

    private:

        TUint32                 iProgState;
        TInt                    iCoverage;
        CActiveSchedulerWait    iWait;    
    };


#endif // CMWLANCOVERAGECHECK_H