Additional Connection Preferences

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.

Context

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 TExtendedConnPref .

Steps

Define Bearer Filtering

Extended Connection Preferences API allows the application to limit the used bearers.
In the below example, only WLAN bearer is allowed.
```
preferences.SetBearerSet( TExtendedConnPref::EExtendedConnBearerWLAN );
```
Disallow Automatic Bearer Switching

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.
The sudden disconnection can be disabled by the applications prior to connection establishment.
```
preferences.SetForcedRoaming( EFalse );
```
Forced roaming applies only on connections made to the Internet SNAP.
Inform middleware that application handles contention

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.
If the Disconnect dialog is disabled, the contention situation is not exposed to the user and the application handles the contention by itself.
```
preferences.SetDisconnectDialog( EFalse );
```
Disable connecting soft notes and Queries

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.
The application can start a connection and roam between different bearers without any notes about connection state shown to the user.
```
preferences.SetNoteBehaviour( TExtendedConnPref::ENoteBehaviourConnDisableNotes );
```
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.
```
preferences.SetNoteBehaviour( TExtendedConnPref::ENoteBehaviourConnDisableQueries ); 
```
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.
```
preferences.SetNoteBehaviour( TExtendedConnPref::ENoteBehaviourConnSilent );
```