--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-3490A064-8421-4ABB-9E93-99A5565CF4D7.dita	Fri Jun 11 12:39:03 2010 +0100
@@ -0,0 +1,62 @@
+<?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>
\ No newline at end of file