// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

 // which accompanies this distribution, and is available

 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 //

 #ifndef IAPPrefs__

 #define IAPPrefs__

 #include <e32base.h>

 #include <msvapi.h>

 #include <msvuids.h>

 #include <cdbcols.h>

 // Note: Version 1 = EPOC6.1

 //		 Version 2 = EPOC6.2 / Hurricane

 const TInt KImIAPPreferencesVersion = 2;	// identify which version of this class has been stored

 // for builds which don't define it.

 /*

 enum TCommDbDialogPref

 	{

 	ECommDbDialogPrefUnknown =0,

 	ECommDbDialogPrefPrompt,

 	ECommDbDialogPrefWarn,

 	ECommDbDialogPrefDoNotPrompt

 	};

 */

 class TImIAPChoice

 /** Sets the connection dialog preference to be used with a particular IAP used 

 for an internet mail service.

 The connection control component (GenConn) allows various options for whether 

 or not the user should be should be prompted with a dialog at connect time. 

 For example, a connection using the first choice GPRS IAP might not show a 

 dialog, but a second choice connection using GSM might bring up a warning. 

 @publishedAll

 @released

 */

 	{

 	public:

 	/** The IAP identifier, as specified in the CommDb record for the IAP. */

 	TUint32	iIAP;

 	/** Preference for what type of dialog is shown before a connection is made using 

 	the specified IAP. */

 	TCommDbDialogPref iDialogPref;

 	};

 class CImIAPPreferences : public CBase

 /** Encapsulates preferences relating to IAPs for an email service.

 An IAP defines all of the variable factors that determine how an Internet 

 connection is made. These variable factors can include the bearer (CDMA, GSM 

 or GPRS), dial-in number. network login names and passwords. 

 The Comms Database is capable of storing details of several IAPs, which can 

 then be used to initiate different types of connection. The database also 

 stores the preference order of the IAPs: this defines which IAP should be 

 used as the first choice, and also an optional second choice to be used if 

 the first choice is not available.

 The CImIAPPreferences class associates a first choice, and optionally a second 

 choice IAP to use with a particular email service. The preference object is 

 stored in the service entry's message store.

 For SMTP, if no object has been stored in the service, then the SMTP client 

 will attempt to use any default Internet settings in the Comms Database, or 

 will use the existing Internet connection if one does already exist. Note 

 that SMTP sessions will normally fail to send any email messages if the SMTP 

 session is not created using an IAP which the SMTP server does not accept.

 Note that in Symbian OS v6.0 a single IAP was associated with an email service 

 entry through the iMtmData1 field. 

 @publishedAll

 @released

 */

 	{

 	public:

 		IMPORT_C static CImIAPPreferences* NewLC();

 		IMPORT_C TInt Version() const;

 		IMPORT_C TInt NumberOfIAPs() const;

 		IMPORT_C TImIAPChoice IAPPreference(TInt aPreference) const;

 		IMPORT_C void AddIAPL(TImIAPChoice aIap, TInt aIndex=0);

 		IMPORT_C void RemoveIAPL(TInt aPreferenceNumber);

 		IMPORT_C TInt FindIAPL(TUint32 aIAP, TInt &aLocation) const;

 		IMPORT_C void ReplaceIAPL(TInt aPreferenceNumber,TImIAPChoice aIap);

 		IMPORT_C ~CImIAPPreferences();

 		IMPORT_C TBool SNAPDefined() const;

 		IMPORT_C TUint32 SNAPPreference() const;

 		IMPORT_C void SetSNAPL(TUint32 aSnap);

 		IMPORT_C void RemoveSNAP();

 		void Reset();

 		// class constants

 		/**

 		@deprecated 

 		*/

 		enum 

 			{

 			KSanityCheckOldWins = 0xEFBEADDE,

 			KSanityCheck = 0xDEADBEEF

 			};

 		/** ID of the stream used to store IAP preference information in a 

 		message store. */

 		const static TUid KUidMsgFileInternetAccessPreferences;

 	private:

 		CArrayFixFlat<TImIAPChoice>* iChoices;

 		TInt iVersion;

 		TUint32 iSnapId;

 	private:

 		CImIAPPreferences();

 		CImIAPPreferences(CImIAPPreferences& aOther); // not implemented

 		int operator=(CImIAPPreferences& aOther); // not implemented

 		void ConstructL();

 		void Panic(int err) const;

 	};

 #endif