/*
* Copyright (c) 2007 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:    Encapsulates ICE related software settings.
*
*/




#ifndef C_CNATFWICESETTINGS_H
#define C_CNATFWICESETTINGS_H


#include <e32base.h>
#include <mnatfwicesettings.h>
#include "tnatfwicepreferences.h"

class CNATFWCenRepHandler;


/**
 *  Class instance encapsulates ICE related software settings.
 *
 *  @lib natfwnatsettings.dll
 *  @since S60 v3.2
 */
class CNATFWIceSettings : public CBase, public MNATFWIceSettings
    {

public:

    /**
     * Two-phased constructor.
     */
    static CNATFWIceSettings* NewL();
    
    /**
     * Two-phased constructor.
     */
    static CNATFWIceSettings* NewLC();
    
    /**
     * Destructor.
     */
    virtual ~CNATFWIceSettings();

    /**
     * Sets preference values.
     *
     * @since   S60 v3.2
     * @param   aPreferences    Preferences
     */
    void SetPreferences( const TNATFWIcePreferences& aPreferences );
    
    /**
     * Sets preference value for a specified setting.
     *
     * @since   S60 v3.2
     * @param   aSetting    Setting for which to set value
     * @param   aValue      Preference value
     * @return  KErrNotSupported if setting is not known, KErrNone otherwise
     */
    TInt SetPrefValue( TPrefSetting aSetting, TInt aValue );
    
    /**
     * Returns preference values.
     *
     * @since   S60 v3.2
     * @return  Preferences
     */
    const TNATFWIcePreferences& Preferences() const;
    
    /**
     * Sets utility plugins.
     * 
     * @since   S60 v3.2
     * @param   aUtilityPlugins Utility plugins
     */
    void SetUtilityPluginsL( const CDesC8Array& aUtilityPlugins );
    
    /**
     * Reads settings values from Central Repository
     * 
     * @since   S60 v3.2
     * @param   aDomainKey  Key for the domain specific settings
     * @param   aRepHandler Central Repository handler 
     */
    void ReadSettingsL( TUint32 aDomainKey,
        const CNATFWCenRepHandler& aRepHandler );
    
// from base class MNATFWIceSettings

    /**
     * From MNATFWIceSettings.
     * Returns preference value for a specifed setting.
     *
     * @since   S60 v3.2
     * @param   aSetting    Setting for which to return preference value
     * @param   aValue      Preference value if query was valid
     * @return  KErrNotSupported if setting is not known, KErrNone otherwise
     */
    TInt GetPrefValue( TPrefSetting aSetting, TInt& aValue ) const;
    
    /**
     * From MNATFWIceSettings.
     * Returns array of identifiers of utility plugins available for ICE.
     * 
     * @since   S60 v3.2
     * @return  Utilities available for ICE
     */
    const CDesC8Array& NatUtilityPlugins() const;
    
private:

    CNATFWIceSettings();

    void ConstructL();

private: // data

    /**
     * ICE preferences for candidate prioritization.
     */
    TNATFWIcePreferences iPreferences;

    /**
     * NAT utility plugins for ICE.
     * Own.
     */ 
    CDesC8Array* iUtilityPlugins;
    };

#endif // C_CNATFWICESETTINGS_H