/*

* Copyright (c) 2002-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 the ScanInfoIe class.

*

*/

#ifndef HSSSCANINFOIE_H

#define HSSSCANINFOIE_H

#include "hssscaninfo.h"

/** Defines the possible types of security information elements. */

enum HssScanInfoIeType

    {

    HssScanInfoIeTypeRsn,

    HssScanInfoIeTypeWpa

    };

/** Defines the possible types of key management suites. */

enum HssScanInfoIeKeyManagement

    {

    HssScanInfoIeKeyManagementEap,

    HssScanInfoIeKeyManagementPsk

    };

/**

* Class determining the security mode of an access point.

*/

class HssScanInfoIe

    {

    public: // Methods

       // Constructors and destructor

        /**

        * C++ default constructor.

        */

        HssScanInfoIe();

        /**

        * Destructor.

        */

        virtual ~HssScanInfoIe();

       // New methods

        /**

        * Parses the given scan information and returns the security

        * mode of the access point.

        * @param info Scan information to be parsed.

        * @return Security mode of the access point.

        */

        HssSecurityMode SecurityMode(

            HssScanInfo& info );

    private: // Methods

        /**

        * Checks whether the given memory buffers are equal.

        * 

        */

        int Compare(

            const unsigned char* pl,

            int ll, 

            const unsigned char* pr, 

            int rl );

        /**

        * Checks whether the given information element defines

        * the expected key management suite.

        */

        TBool IsKeyManagement(

            HssScanInfoIeType ie_type,

            HssScanInfoIeKeyManagement key_type,

            TUint8 ie_length,

            const TUint8* ie_data

            );

        /**

        * Checks whether the given information element defines

        * valid ciphers suites for WPA2.

        */

        TBool IsWpa2Ciphers(

            HssScanInfoIeType ie_type,

            TUint8 ie_length,

            const TUint8* ie_data

            );

        // Prohibit copy constructor if not deriving from CBase.

        HssScanInfoIe(

            const HssScanInfoIe& );

        // Prohibit assigment operator if not deriving from CBase.

        HssScanInfoIe& operator= (

            const HssScanInfoIe& );

    };

#endif // HssSCANINFOIE_H