Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

How to set default access point using Qt Mobility APIs

From Wiki
Jump to: navigation, search
Article Metadata
Created: gaba88 (29 Mar 2010)
Last edited: hamishwillee (11 Oct 2012)
ID Creation date 29th Mar 2010
Platform S60 5th Edition Tested on devices Nokia N97
Category Qt Subcategory Qt Mobility API

Keywords (APIs, classes, methods, functions): QNetworkSession, QNetworkConfigurationManager,QConfigurationManager

Tip.pngTip: Read this article before moving forward: Archived:Setting up environment for Qt Mobility API



This article demonstrate how to set default access point using the Bearer Management APIs of the Qt's Mobility Package.

Project Configuration File (.pro file)

Add the Qt Mobility project configuration option in the .Pro file as shown below

CONFIG += mobility
MOBILITY += bearer

Header File

Also do add the Qt mobility name space before using any Qt mobility APIs,


Declare a QNetworkSession object in the header file which will help in opening the network connections.

#include <qmobilityglobal.h>
#include <qnetworksession.h>
QNetworkSession* session;

Source File

After declaring the QNetworkSession object we need to use the QNetworkConfigurationManager and QNetworkConfiguration class to ask the user about the access point and make that as a default connection.

A sample function is shown below :

    QNetworkConfigurationManager manager;
const bool selectIap = (manager.capabilities()& QNetworkConfigurationManager::CanStartAndStopInterfaces);
QNetworkConfiguration defaultIap = manager.defaultConfiguration();
if(!defaultIap.isValid() && (!selectIap && defaultIap.state() != QNetworkConfiguration::Active))
// let the user know that there is no access point available
session = new QNetworkSession(defaultIap,this);

It is worth noting that QNetworkConfigurationManager::defaultConfiguration() reflects the device's default connection setting, which can be controlled from the UI. The default connection varies slightly from device to device. For example on 5800 device, navigate to Menu -> Settings -> Connectivity -> Destinations -> Options -> Default Connection to control this setting. Notably, it the setting is set as 'Always Ask', user will be prompted every time.

If you need more control over which configuration is used, what you can do is list the configurations (QNetworkConfigurationManager::allConfigurations()), choose the one you wish to use, and create a QNetworkSession based on that configuration (similarly as in the example snippet above).


  • In one of my previous article I explained the HTTP GET and POST mechanism using Qt's APIs, that article can be easily extended to ask the user at first to select an access point and make that as default connection.
  • The screenshots shown below illustrates the above point clearly:

QDefaultAccessPoint1.jpg QDefaultAccessPoint2.jpg


This page was last modified on 11 October 2012, at 01:23.
42 page views in the last 30 days.