/*
* Copyright (c) 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:  vimpst settings store definitions
*
*/

#ifndef __CVIMPSTSETTINGSSTORE_H
#define __CVIMPSTSETTINGSSTORE_H

#include <e32base.h>

/** types of settings provided in meco settings */
enum TSettingItemName
    {
    ETOUDlgOff = 0x00000000,                      // key value to enable or disable TOU Dialog to be shown
    EURLRegistrationOff = 0x00000001,             // key value to enable or disable URL registration query
    EServiceSuccessfullLogin = 0x00000002,
    EServiceToneFileName = 0x00000003,              // key value to get the IM tone File name.complete path of the file name should be provided. example                       
    EServiceURLLink = 0x00000004,                    // key value to get the URL link for IM based on service     
    EServiceAvatar = 0x00000005,                  // key value to get the Own Avatar for IM based on service    
    EServiceAvatarMimeType = 0x00000006,          // key value to get the Own Avatar s 'mimetype' for IM based on service   
    EServiceOwnAvatarIconIndex = 0x00000007 ,         // key value to get the Own Icon index for avatar s  
    // key value to check whether the  "Cancel Login" is supported or not   
    // if setting "value = 1" then cancel login not supported else supported.
    // if cancel is supported , no need to write anything to cenrep.
    // By default its taken as supported.
    // if not supported then write explicitly this setting as '1'
    EServiceCancelLoginNotSupported = 0x00000008        
    };                                                      



//CLASS  DECLARATION
/**  
 *  M-Class for meco settingstore API's 
 *  @lib vimpstsettingsstore.lib
 *  @since S60 5.0
 */
class MVIMPSTSettingsStore
    {        
    public:     //Interface
        
        /**
         * virtual Destructor.
         */
        virtual ~MVIMPSTSettingsStore()
            {
            }
                
        /**
         * Peforms Get/Set operation in the cenrep
         * @param aServiceId, id if the service for which settings are get/set      
         * @param aSettingItemName, setting item name 
         * @param aBuffer, variable to set/get the value
         * @return TInt, used as error passing value.  
         */  
        virtual TInt GetL(TUint32 aServiceId, TSettingItemName aSettingItemNAme, RBuf& aBuffer )  = 0;        
        virtual TInt SetL(TUint32 aServiceId, TSettingItemName aSettingItemNAme, const TDesC8& aBuffer ) = 0;
        
    };

/**
 *  vimpst settings API class
 *
 *  Main class of managing vimpst settings
 *
 *  @code example code of how to get/set a value to the setting item in cenrep 
 *  MVIMPSTSettingsStore* obj = CVIMPSTUiSettingsStoreFactory::NewL();
 *  TInt value = 1;
 *  TInt err = obj->Set(serviceId, ETOUDlgOff, value );
 *  similarly for getting the value
 *  obj->Get(serviceId, ETOUDlgOff, value);
 *  @lib vimpstsettingsstore.lib
 *  @since S60 v5.0
 */
NONSHARABLE_CLASS( CVIMPSTSettingsStore ): public CBase
    {

    public: // Constructors and destructor

        /**
        * Two-phased constructor.
        */
        IMPORT_C static MVIMPSTSettingsStore* NewL();
        
        /**
         * Two-phased constructor.
         */
        IMPORT_C static MVIMPSTSettingsStore* NewLC();
        
        /**
        * Destructors.
        */
        virtual ~CVIMPSTSettingsStore();  
    };

#endif /*__CVIMPSTSETTINGSSTORE_H*/