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

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE task

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

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

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

    14 a few additional preferences that customize the connection establishment.

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

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

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

    18 connection preferences that can be set using the Extended Connection

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

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

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

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

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

    24 Filtering</b></cmd>

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

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

    27 </codeblock></info>

    28 </step>

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

    30 Bearer Switching</b></cmd>

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

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

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

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

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

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

    37 </step>

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

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

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

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

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

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

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

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

    46 </step>

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

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

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

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

    51 The application can disable these soft notes using the Extended Connection

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

    53 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

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

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

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

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

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

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

    60 </step>

    61 </steps-unordered>

    62 </taskbody></task>