/*

* 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:

*

*

*/

#ifndef CMMANAGER_H

#define CMMANAGER_H

#include <e32base.h>

#include <cmdefconnvalues.h>

#include <cmgenconnsettings.h>

class RCmConnectionMethod;

class RCmDestination;

class TBearerPriority;

/**

 *  RCmManager gives access to network destinations and connection methods.

 *

 *  @lib cmmanager.lib

 *  @since S60 v3.2

 */

    public:

        /**

        */

        inline RCmManager();

        /**

        * Symbian constructor

        *

        * @since S60 3.2

        */

        /**

        * Symbian constructor

        * Pushes the object on the cleanup stack

        *

        * @since S60 3.2

        */

        /**

        * Secondary destructor

        *

        * @since S60 3.2

        */

        IMPORT_C void Close();

        /**

        * Used to query bearer information that doesn't belong

        * ECmCoverage or ECmDefaultPriority etc.

        *

        * @since S60 3.2

        * @param aBearerType the bearer

        * @param aAttribute the setting value

        * @return the setting value

        */

        /**

        * Used to query bearer information that doesn't belong

        * ECmCoverage or ECmDefaultPriority etc.

        *

        * @since S60 3.2

        * @param aBearerType the bearer

        * @param aAttribute the setting value

        * @return the setting value

        */

        /**

        * Used to query bearer information that doesn't belong

        * ECmCoverage or ECmDefaultPriority etc.

        * HBuf ownership is passed to the caller

        *

        * @since S60 3.2

        * @param aBearerType the bearer

        * @param aAttribute the setting value

        * @return the setting value

        /**

        * Used to query bearer information that does not belong

        * ECmCoverage or ECmDefaultPriority, etc.

        * HBuf ownership is passed to the caller

        *

        * @since S60 3.2

        * @param aBearerType the bearer

        * @param aAttribute the setting value

        * @return the setting value

        */

        /**

        * Used to query any non-bearer specific information about

        * a given connection method. This can be e.g. ECmBearerType,

        * ECmName, ECmStartPage, etc.

        *

        * @since S60 3.2

        * @param aIapId the connection method id

        * @param aAttribute the setting value

        * @return the setting value

        */

        /**

        * Used to query any, non-bearer specific information about

        * a given connection method. This can be e.g. ECmBearerType,

        * ECmName, ECmStartPage, etc.

        *

        * @since S60 3.2

        * @param aIapId the connection method id

        * @param aAttribute the setting value

        * @return the setting value

        */

        /**

        * Used to query any non-bearer specific information about

        * a given connection method. This can be e.g. ECmBearerType,

        * ECmName, ECmStartPage, etc.

        * HBuf ownership is passed to the caller

        *

        * @since S60 3.2

        * @param aIapId the connection method id

        * @param aAttribute the setting value

        * @return the setting value

        */

        /**

        * Used to query any non-bearer specific information about

        * a given connection method. This can be e.g. ECmBearerType,

        * ECmName, ECmStartPage, etc.

        * HBuf ownership is passed to the caller

        *

        * @since S60 3.2

        * @param aIapId the connection method id

        * @param aAttribute the setting value

        * @return the setting value

        */

        /**

        * Returns the connection method queried by its ID

        *

        * @since S60 3.2

        * @param aConnectionMethodId id of the connection method

        * @return RCmConnectionMethod connection method

        */

        /**

        * filtered by the switch parameters e.g. aLegacyOnly.

        *

        * @since S60 3.2

        * @param aCMArray on return it is the array of IAP ids.

        *                         supported bearer type are returned

        * @param aLegacyOnly when set to ETrue only Legacy IAP ids will

        *                         be returned

        * @param aEasyWlan when set to ETrue EasyWlan id is returned, too

        */

        /**

        * Returns an array of all destination id's

        *

        * @since S60 3.2

        * @param aDestArray list all available destinations' id

        IMPORT_C void AllDestinationsL( RArray<TUint32>& aDestArray ) const;

        /**

        * connection method belongs, search is by destination ID

        *

        * @since S60 3.2

        * @param aDestinationId id of destination

        */

        IMPORT_C RCmDestination DestinationL( TUint32 aDestinationId ) const;

        /**

        * Returns the copy of the bearer priority array. Ownership is passed.

        *

        * @since S60 3.2

        * @param aArray bearer priority array

        /**

        * Clean up passed global bearer priority array. Delete

        * the elements and calls Reset and Close on the array.

        *

        * @since S60 3.2

        * @param aArray array to be cleaned up

        */

        /**

        * Returns the id of the EasyWlan connection method.

        *

        * @since S60 3.2

        * @return id of the EasyWLan connection method. 0 if not found.

        */

        IMPORT_C TUint32 EasyWlanIdL() const;

        /**

        * Returns the default connection method/SNAP.

        *

        * @since S60 3.2

        */

        /**

        * Stores the default connection method/SNAP.

        *

        * @since S60 3.2

        */

        /**

        * Returns the general connection settings.

        *

        * @since S60 9.2

        */

        IMPORT_C void ReadGenConnSettingsL( TCmGenConnSettings& aGenConnSettings );

        /**

        * Writes the general connection settings.

        *

        * @since S60 9.2

        */

        IMPORT_C void WriteGenConnSettingsL( const TCmGenConnSettings& aGenConnSettings );

        /** Open session and create tables if they don't exist*/

        /**

        * @param aName the name of the new destination.

        * caller

        */

        IMPORT_C RCmDestination CreateDestinationL( const TDesC& aName );

        /**

        * Creates a connection method does not belong to any destination

        * @param aImplementationUid - bearer type of the new connection method

        * @return RCmConnectionMethod newly created connection method.

        */

        /**

        * another. The connection method becomes shared.

        * Calls UpdateL on the destination

        * @param aTargetDestination

        * @param aConnectionMethodId

        * @return TInt - index in the Connection Method list

        */

        /**

        * another. The connection method is removed from the source destination

        * @param aSourceDestination

        * @param aTargetDestination

        * @param aConnectionMethod

        * @return TInt - index in the Connection Method list

        */

        /**

        * Remove connection method from the destination

        * @param aDestination destination the connection method is attached to

        * @param aConnectionMethod connection method to be removed

        */

        /**

        * uncategorized.

        * @param aConnectionMethod connection method to be removed

        */

        /**

        * Update bearer priority array

        * @param aArray array with new global bearer priority

        /**

        * @param aName the name of the new destination.

        * @param aDestId Predefined id of the destination.

        * @return RCmDestination newly created destination or leaves with

        * KErrAlreadyExists if there exists CM with the same Id.

        * Ownership is passed to the caller.

        */

        /**

        * Creates a connection method does not belong to any destination

        * @param aImplementationUid - bearer type of the new connection

        * method

        * @param aConnMethodId Predefined id for the connection method.

        * @return RCmConnectionMethod newly created connection

        * method or leaves with KErrAlreadyExists if there exists CM

        * with the same Id.

        */

        /**

        * Query all of the supported bearer types.

        * @param aArray list of all supported bearer types.

        IMPORT_C void SupportedBearersL( RArray<TUint32>& aArray ) const;

        /**

    private:

        /**

        * This is a private copy constructor without implementation.

        * the objects of this class.

        /**

        * This is a private copy constructor without implementation.

        * the objects of this class.

        RCmManager& operator=( RCmManager& );

    private:

    };

#endif // CMMANAGER_H