diff -r 63be7eb3fc78 -r f28ada11abbf wlanutilities/wlansniffer/apwizard/inc/wsfwlanssiddiscovery.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/wlanutilities/wlansniffer/apwizard/inc/wsfwlanssiddiscovery.h Wed Sep 01 12:20:32 2010 +0100 @@ -0,0 +1,157 @@ +/* +* 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 CWsfWlanSsidDiscovery +* +*/ + + + +#ifndef C_WSFWLANSSIDDISCOVERY_H +#define C_WSFWLANSSIDDISCOVERY_H + + +// EXTERNAL INCLUDES +#include +#include + + +// FORWARD DECLARATIONS +class CWlanMgmtClient; +class CWlanScanInfo; + + +// CLASS DEFINITION +/** +* Class to carry out WLAN SSID discovery +* +* @since S60 5.0 +* @lib wsfapwizard.lib +*/ +NONSHARABLE_CLASS( CWsfWlanSsidDiscovery ): public CActive + { + /** + * States of the WLAN discovery + */ + enum TWsfWlanDiscoveryState + { + /** + * Scanning has been started + */ + EScanning, + + /** + * Scanning finished + */ + EDone, + + /** + * Scanning was aborted + */ + EAborted + }; + + + public: + /** + * Factory function. + * @since S60 5.0 + * @return Class instance + */ + static CWsfWlanSsidDiscovery* NewL(); + + /** + * Destructor + * @since S60 5.0 + */ + ~CWsfWlanSsidDiscovery(); + + + private: + /** + * Constructor + * @since S60 5.0 + */ + CWsfWlanSsidDiscovery(); + + /** + * Second-phase constructor + * @since S60 5.0 + */ + void ConstructL(); + + + public: // new methods + /** + * Executes a direct/broadcast scan + * @since S60 5.0 + * @param aSsid The SSID to look for in case of direct scan + * @param aBroadcast If set to ETrue, does a broadcast scan, + * otherwise direct + * @param aNetworkMode Network mode for the found network + * @param aSecurityMode Security mode for the found network + * @param aUsesPsk ETrue if the found network uses PSK in WPA mode + * @return ETrue if the scan was successful, otherwise EFalse + */ + TBool ScanForSsidL( TWlanSsid& aSsid, + TBool aBroadcast, + CMManager::TWlanNetMode& aNetworkMode, + CMManager::TWlanSecMode& aSecurityMode, + TBool& aUsesPsk ); + + /** + * Aborts the scanning process + * @since S60 5.0 + */ + void AbortScanning(); + + + private: // from CActive + + /** + * Implements cancellation of an outstanding request. + * @since S60 5.0 + */ + void DoCancel(); + + /** + * Handles an active object's request completion event. + * @since S60 5.0 + */ + void RunL(); + + + private: // data + /** + * Progress state + */ + TUint32 iProgState; + + /** + * Nested waitloop + */ + CActiveSchedulerWait iWait; + + /** + * Wlan management client interface (owned) + */ + CWlanMgmtClient* iWlanMgmt; + + /** + * Scan info object (owned) + */ + CWlanScanInfo* iScanInfo; + }; + + +#endif // C_WSFWLANSSIDDISCOVERY_H