<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 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 

"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: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-3490A064-8421-4ABB-9E93-99A5565CF4D7" xml:lang="en"><title>Additional

Connection Preferences</title><shortdesc>Extended Connection Preferences API allows applications to set

a few additional preferences that customize the connection establishment.

These preferences, when used with specific SNAP ID, SNAP Type , IAP or connection

selection dialog enable the applications to have more control on the connection.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context id="GUID-9A074511-667D-43E5-80D8-3FDAE3321E09"><p>The additional

connection preferences that can be set using the Extended Connection

Preferences API are listed below. One or more of the preferences can be set

based on connection establishment requirements. For more details on the restrictions

regarding the preferences that can be used jointly, refer <xref href="GUID-B78E8AC0-CDC8-3DEC-AF3C-98C8994DA34A.dita"><apiname> TExtendedConnPref </apiname></xref> .</p></context>

<steps-unordered id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-10-1-14-1-1-4-1-1-5-1-1-7-1-3-2">

<step id="GUID-81D0BBB7-82EA-46B5-98A6-1BD426777AA5"><cmd><b>Define Bearer

Filtering</b></cmd>

<info><p>Extended Connection Preferences API allows the application to limit

the used bearers.</p><p>In the below example, only WLAN bearer is allowed.</p><codeblock xml:space="preserve">preferences.SetBearerSet( TExtendedConnPref::EExtendedConnBearerWLAN );

</codeblock></info>

</step>

<step id="GUID-E819B95A-90D2-4E80-89B5-3A3EAF1BCBDB"><cmd><b>Disallow Automatic

Bearer Switching</b></cmd>

<info><p>The established connection can be broken by the middleware when a

better connection is available. For example, when a known WLAN IAP is available,

the established 3G connection is disconnected. This is also known as Forced

Roaming. Forced Roaming is enabled by default.</p><p> The sudden disconnection

can be disabled by the applications prior to connection establishment. </p><codeblock xml:space="preserve">preferences.SetForcedRoaming( EFalse );</codeblock><p>Forced

roaming applies only on connections made to the Internet SNAP.</p></info>

</step>

<step id="GUID-85E14D5A-4F68-49E9-9DBB-1E52EFA09289"><cmd><b>Inform middleware

that application handles contention</b> </cmd>

<info><p>When there are multiple active connections and there is a requirement

for a new connection , the list of active connections are displayed and the

user selects the connection to be disconnected. This accommodates the new

connection request to be processed. </p><p>If the Disconnect dialog is disabled,

the contention situation is not exposed to the user and the application handles

 the contention by itself.</p><codeblock xml:space="preserve">preferences.SetDisconnectDialog( EFalse );</codeblock></info>

</step>

<step id="GUID-0C8D3720-047B-4449-9645-6788ED6E0BE8"><cmd><b>Disable connecting

soft notes and Queries</b></cmd>

<info><p>During connection establishment , pop-ups(soft notes) indicate the

state of the connection providing visibility and cost awareness to the user.

The application can disable these soft notes using the Extended Connection

Preferences API. </p><p>The application can start a connection and roam between

different bearers without any notes about connection state shown to the user.</p><codeblock xml:space="preserve">preferences.SetNoteBehaviour( TExtendedConnPref::ENoteBehaviourConnDisableNotes );</codeblock><p>The application can start a connection and roam between different bearers

without displaying any queries to the user but inform the user on the events

with dialogs or notes. The user is able to see the notes about connection

state. Queries that need user confirmation are not exposed to the user.</p><codeblock xml:space="preserve">preferences.SetNoteBehaviour( TExtendedConnPref::ENoteBehaviourConnDisableQueries ); 

</codeblock><p>The application can start a connection and roam between different

bearers without any queries, dialogs or notes. The connection state details

are not exposed to the user.</p><codeblock xml:space="preserve">preferences.SetNoteBehaviour( TExtendedConnPref::ENoteBehaviourConnSilent );</codeblock></info>

</step>

</steps-unordered>

</taskbody></task>