<?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-A2F691C8-9525-4028-BF82-70E9D50630C6" xml:lang="en"><title>Prompting
the User to Select a Destination Network</title><shortdesc>If there is no connection specified in the connection setup and
no default connection has been defined, your application can
prompt the user to select the connection.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context id="GUID-0577782B-4D55-42BF-8028-8531DF343265">       <p>To prompt
the user select the destination network:</p>     </context>
<steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-10-1-14-1-1-7-1-5-1-3-2">
<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-10-1-14-1-1-7-1-5-1-3-2-1"><cmd>Start the connection
with <xref href="GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD.dita#GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD/GUID-A299EA7A-29FD-30B4-A077-762200433627"><apiname>RConnection::Start(ECommDbDialogPrefPrompt)</apiname></xref>.  RConnection
handle is returned to the application. </cmd>
</step>
<step id="GUID-5E21239D-0A4F-43A1-A51A-7E9F5863D9B1"><cmd>The user makes a selection.  A destination network is the preferred
selection, but the user can also select a specific access point with this
dialog. </cmd>
</step>
<step id="GUID-DA2AF32D-AECD-406A-82D0-88556A6FE649"><cmd>Link layer is now ready for the application.</cmd>
</step>
<step id="GUID-27736BF6-FDD6-4426-ADFA-65EBD73BF86D"><cmd>Send <xref href="GUID-12D64410-F872-3BBD-9B95-CAF939ED56F6.dita"><apiname>NewL(RConnection handle, MMobilityProtocolResp()</apiname></xref>.
 The application can now use the mobility API, but if the user selected an
access point this has no meaning, because roaming cannot be used.  For information
on how to start the connection through a destination network, see Starting
the connection through the destination network. </cmd>
</step>
</steps>
<example><codeblock xml:space="preserve">RSocketServ ss;

// Connect to ESOCK
ss.Connect();

// Open an RConnection object.  Note that you must provide an RSocketServ object
RConnection conn;
conn.Open( ss );

// Create overrides
TCommDbConnPref prefs;
prefs.SetDialogPreference( ECommDbDialogPrefPrompt );

// Start an Outgoing Connection with overrides
conn.Start( prefs );</codeblock></example>
</taskbody></task>