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

#if !(defined COMMDBCONNPREF_H)
#define COMMDBCONNPREF_H

#include <connpref.h>
#include <cdbcols.h>

class TCommDbConnPref : public TConnPref
/** Connection preferences which override the contents of the ConnectionPreferences
tables in CommsDat. The only mandatory field is IAP.

An Internet Access Point(IAP) represents a IP bound bearer and a set of parameters
on that bearer, which the device can use to make a connection to the Internet.

A list of available IAPs and Networks can be retrieved from CommsDat using
CommsDat::CCDIAPRecord and CCDNetworkRecord.

@code
RConnection conn;
User::LeaveIfError(conn.Open(sockSvr));
CleanupClosePushL(conn);

TCommDbConnPref prefs;
prefs.SetIapId(3);
TInt error = conn.Start(prefs);
@endcode

@see CommsDat::CCDNetworkRecord
@see CommsDat::CCDIAPRecord
@see TCommDbDialogPref
@see TCommDbConnectionDirection
@see TCommDbBearer
@see RConnection::Start

@publishedAll
@released since v7.0s
*/
	{
	friend class TCommDbMultiConnPref;
public:
	IMPORT_C TCommDbConnPref();
	IMPORT_C static TVersion Version();

	IMPORT_C void SetIapId(TUint32 aIapId);
	IMPORT_C TUint32 IapId() const;

	IMPORT_C void SetNetId(TUint32 aNetId);
	IMPORT_C TUint32 NetId() const;

	IMPORT_C void SetDialogPreference(TCommDbDialogPref aDialogPref);
	IMPORT_C TCommDbDialogPref DialogPreference() const;

	IMPORT_C void SetDirection(TCommDbConnectionDirection aDirection);
	IMPORT_C TCommDbConnectionDirection Direction() const;

	IMPORT_C void SetBearerSet(TUint32 aBearerSet);
	IMPORT_C TUint32 BearerSet() const;

	IMPORT_C virtual TInt Compare(const TCommDbConnPref& aPref) const;
	inline TBool operator==(const TCommDbConnPref& aPref) const;
	inline TBool operator!=(const TCommDbConnPref& aPref) const;

	inline static TCommDbConnPref& Cast(const TConnPref& aPref);

public:
    struct SCommDbConnPref
        {
        TUint32 iIapId;
        TUint32 iNetId;
        TCommDbDialogPref iDialogPref;
        TCommDbConnectionDirection iDirection;
        TUint32 iBearerSet;
        };
	inline SCommDbConnPref* PrefPtr() const;
    const static TInt8 KMajorVersionNumber = 8;
    const static TInt8 KMinorVersionNumber = 0;
    const static TInt16 KBuildVersionNumber = 1;
	};



class TCommDbMultiConnPref : public TConnPref
/** A set of TCommDbConnPrefs which the device will use to attempt to connect
to the internet. The preferences at index 1 will be used first, and if this fails
the preferences at index 2 will be used, and so on until connection attempts
are exhausted.

The index counts from 1. There must be as many connection preferences as there
are connection attempts.

@code
RConnection conn;
User::LeaveIfError(conn.Open(sockSvr));
CleanupClosePushL(conn);

TCommDbConnPref prefsA;
prefsA.SetIapId(3);
TCommDbConnPref prefsB;
prefsB.SetIapId(5);

TCommDbMultiConnPref prefs;
prefs.SetPreference(1, prefsA);
prefs.SetPreference(2, prefsB);
prefs.SetConnectionAttempts(2);

TInt error = conn.Start(prefs);
@endcode

@see TCommDbConnPref
@see RConnection::Start

@publishedAll
@released since v7.0s
*/
	{
public:
	IMPORT_C TCommDbMultiConnPref();
	IMPORT_C static TVersion Version();

	IMPORT_C TInt SetPreference(TInt aIndex, const TCommDbConnPref& aPref);
	IMPORT_C TInt GetPreference(TInt aIndex, TCommDbConnPref& aPref);

	IMPORT_C void SetConnectionAttempts(TInt aNumAttempts);
	IMPORT_C TInt ConnectionAttempts();

	inline static TCommDbMultiConnPref& Cast(const TConnPref& aPref);

public:
    const static TInt KMaxMultiConnPrefCount = 2;
    struct SCommDbMultiConnPref
        {
        TInt iNumAttempts;
        struct TCommDbConnPref::SCommDbConnPref iPrefs[KMaxMultiConnPrefCount];
        };
	inline struct SCommDbMultiConnPref* PrefPtr() const;
    const static TInt8 KMajorVersionNumber = 8;
    const static TInt8 KMinorVersionNumber = 0;
    const static TInt16 KBuildVersionNumber = 1;
	};

#include <commdbconnpref.inl>

#endif
// COMMDBCONNPREF_H