diff -r 2fe1408b6811 -r e1b950c65cb4 epoc32/include/iapprefs.h --- a/epoc32/include/iapprefs.h Tue Mar 16 16:12:26 2010 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,132 +0,0 @@ -// 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 -#include -#include -#include - -// 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* 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