Starting the connection through the destination network

After you have selected the destination network to be used, you can open the data connection. For more information on making the selection, see Defining connection management items and Prompting the user to select a destination network.

To open the data connection with the selected destination network:

  1. Start the connection through the Internet destination network using the Connection Manager API.

  2. Select the best available IAP within the Internet destination network using the Connection Manager API.

    RConnection handle is returned to the network. The connection can now be used.

The following code snippet illustrates this process.

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
TConnSnapPref prefs
prefs.SetSnap( 4 );

// Start an Outgoing Connection with overrides
conn.Start( prefs );

Additional information

Connection Manager API (often referred to as RConnection API because Symbian does not collect APIs into similar logical entities as the S60 platform does) is a collection of Symbian's connection management-related functionalities provided by ESOCK. It contains several extensions and one of them is the mobility extension. The term "mobility API" actually refers to the mobility extensions that are part of Connection Manager API and defined in header cs_mobility_apiext.h. With the so-called mobility API the client application can register for mobility events, receive information about preferred connections, indicate whether to switch to a new connection or ignore it. In short, it enables ALR for the applications.

For more information on making IP connections, see Making an IP connection.

Related S60 platform services

The S60 platform also offers the following related services:

  • Dialog and note components for notifying the mobile device user of network connections

  • Browsing and downloading for enabling content browsing and downloading services through your application

  • Secure Sockets API for adding authentication to an IP connection and encrypting the data that is transferred

    Note: This API is provided by the Symbian OS.

  • HTTP Client API for using the HTTP protocol for communication over the Internet

    Note: This API is provided by the Symbian OS.

© Nokia 2009.