// under the terms of "Eclipse Public License v1.0"

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

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

public:

    struct SCommDbConnPref

        {

        TUint32 iIapId;

        TUint32 iNetId;

        TCommDbDialogPref iDialogPref;

        TCommDbConnectionDirection iDirection;

        TUint32 iBearerSet;

        };

    const static TInt8 KMajorVersionNumber = 8;

    const static TInt8 KMinorVersionNumber = 0;

    const static TInt16 KBuildVersionNumber = 1;

/** 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

public:

    const static TInt KMaxMultiConnPrefCount = 2;

    struct SCommDbMultiConnPref

        {

        TInt iNumAttempts;

        struct TCommDbConnPref::SCommDbConnPref iPrefs[KMaxMultiConnPrefCount];

        };

    const static TInt8 KMajorVersionNumber = 8;

    const static TInt8 KMinorVersionNumber = 0;

    const static TInt16 KBuildVersionNumber = 1;