<?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-722180B8-0032-5C3F-AEB2-A9B1261450D8" xml:lang="en"><title> Starting

a Socket Server connection: Tutorial</title><shortdesc>This tutorial describes how to start an <codeph>RConnection</codeph> connection.

Each connection must be started to link the connection with the network interface

hardware. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context id="GUID-62356291-EB29-4139-93A9-CB0F8F81F078"><p><b>Implicit Connection Startup</b></p><p>In the following example,

the application is unaware of the connection and does not have an instance

of <xref href="GUID-BED8A733-2ED7-31AD-A911-C1F4707C67FD.dita"><apiname>RConnection</apiname></xref>. This might be used if an application tries

to connect a socket or resolve a name and the socket server detects that a

connection has not been started. This example does not differ from previous

versions of the Symbian platform.</p><p>Note: Error handling is not included

to aid clarity.  </p><codeblock xml:space="preserve">RSocketServ ss;

RSocket sock;

TRequestStatus status;

// Connect to the socket server

ss.Connect();

// Open a TCP socket 

sock.Open(ss, KAfInet, KSockStream, KProtocolInetTcp);

_LIT(KRasAddr,"10.159.24.13");

const TInt KEchoPort = 7;

TInetAddr destAddr;

destAddr.Input(KRasAddr);

destAddr.SetPort(KEchoPort);

// Request the Socket to connect to the destination (implicit Connection)

sock.Connect(destAddr, status);

</codeblock></context>

<example><title>Explicit Connection Startup</title> <p>The following example

shows how an application can start a connection explicitly via an <codeph>RConnection</codeph> instance,

and tie an <codeph>RHostResolver</codeph> and <codeph>RSocket</codeph> to

the connection started. </p> <p>The application is able to override the connection

preference settings in CommDb allowing it to specify the Network, IAP, ISP

and bearer used. Code examples are given for the cases with and without overrides. </p> <p>See <xref href="GUID-739117F6-9559-3274-8E00-B2B653C0A8B6.dita"><apiname>TCommDbConnPref</apiname></xref> for

information about how to set up the connection. </p> <codeblock id="GUID-1B9252B9-B731-55A0-A379-E51D94ACF768" xml:space="preserve">

RSocketServ ss;

TRequestStatus status;

RConnection conn;

_LIT(KRasAddr,"10.159.24.13");

const TInt KEchoPort = 7;

TInetAddr destAddr;

destAddr.Input(KRasAddr);

destAddr.SetPort(KEchoPort);

// Connect to the socket server

ss.Connect();

// Open an RConnection object. Note that you must provide the RSocketServ object

conn.Open(ss);

// Create overrides

TCommDbConnPref prefs;

prefs. SetDialogPreference(ECommDbDialogPrefDoNotPrompt);

prefs.SetDirection(ECommDbConnectionDirectionOutgoing);

prefs.SetIapId(4);

// Start an Outgoing Connection with overrides

conn.Start(prefs);

// Open a Host Resolver associated with the connection

RHostResolver hr;

hr.Open(ss, KAfInet, KProtocolInetTcp, conn);

// Open a Socket associated with the connection

RSocket sock;

sock.Open(ss, KAfInet, KSockStream, KProtocolInetTcp, conn);

// Request the Socket to connect to the destination

sock.Connect(destAddr, status);

</codeblock> </example>

</taskbody></task>