// Copyright (c) 2005-2009 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:

 //

 /**

  @file 

  @internalTechnology 

 */

 #if !defined(__SS_CONNSETTINGS_H__)

 #define __SS_CONNSETTINGS_H__

 #include <e32def.h>

 #include <e32base.h>

 /**

  Base class that any client wishing to access underlying comms database settings

  @internalTechnology

  @released Since 9.1

  @see CConnectionProvider

  */

 class CConnectionSettings : public CBase

 	{

 public:

 	IMPORT_C CConnectionSettings();

 	IMPORT_C void GetBoolSettingL(const TDesC& aSettingName, TBool& aValue, const RMessagePtr2* aMessage );

 	IMPORT_C void GetDes16SettingL(const TDesC& aSettingName, TDes16& aValue, const RMessagePtr2* aMessage );

 	IMPORT_C void GetDes8SettingL(const TDesC& aSettingName, TDes8& aValue, const RMessagePtr2* aMessage );

 	IMPORT_C void GetIntSettingL(const TDesC& aSettingName, TUint32& aValue, const RMessagePtr2* aMessage );

 	IMPORT_C HBufC* GetLongDesSettingLC(const TDesC& aSettingName, const RMessagePtr2* aMessage );

 protected:

 	/**

 	 Override this to retrieve a boolean value from the database with the given field name

 	 @param aSettingName Field name

 	 @param aValue Reference to a boolean that will contain the value on call success

 	 @param aMessage RMessage pointer required for secure session communication

 	 */

 	virtual void DoGetBoolSettingL(const TDesC& aSettingName, TBool& aValue, const RMessagePtr2* aMessage ) = 0;

 	/**

 	 Override this to retrieve a unicode string value from the database with the given field name

 	 @param aSettingName Field name

 	 @param aValue Reference to a string that will contain the value on call success

 	 @param aMessage RMessage pointer required for secure session communication

 	 */

 	virtual void DoGetDes16SettingL(const TDesC& aSettingName, TDes16& aValue, const RMessagePtr2* aMessage ) = 0;

 	/**

 	 Override this to retrieve a 8-bit string value from the database with the given field name

 	 @param aSettingName Field name

 	 @param aValue Reference to a string that will contain the value on call success

 	 @param aMessage RMessage pointer required for secure session communication

 	 */

 	virtual void DoGetDes8SettingL(const TDesC& aSettingName, TDes8& aValue, const RMessagePtr2* aMessage ) = 0;

 	/**

 	 Override this to retrieve a unsigned 32-bit int value from the database with the given field name

 	 @param aSettingName Field name

 	 @param aValue Reference to a TUint32 that will contain the value on call success

 	 @param aMessage RMessage pointer required for secure session communication

 	 */	

 	virtual void DoGetIntSettingL(const TDesC& aSettingName, TUint32& aValue, const RMessagePtr2* aMessage ) = 0;

 	/**

 	 Override this to retrieve a string value as a heap allocated buffer from the database with the given field name

 	 @param aSettingName Field name	 

 	 @param aMessage RMessage pointer required for secure session communication

 	 @return Pointer to the dynamically allocated string

 	 */

 	virtual HBufC* DoGetLongDesSettingLC(const TDesC& aSettingName, const RMessagePtr2* aMessage ) = 0;

 	};

 #endif	// __SS_CONNSETTINGS_H__