Defining connection management items

Your application should define which connection management items (destination networks, IAPs, default connection and always ask) it supports and show only the supported items in the UI. In this example, the application supports default connection, always ask and destination networks. IAPs (if supported) of a certain destination network can be seen under the Options menu when the destination network is highlighted.

To define the connection management items:

1. Request the connection settings dialog for supported items using the Connection Settings UI API.

2. Show the items that your application supports in the UI using the Connection Settings UI API.

   After the user has made a selection, it is returned to the application.

3. Store the user selection in the application's connection setup.

   For information on how to start the connection through a destination network, see Starting the connection through the destination network.

   If you want to prompt the user to make this selection, see Prompting the user to select a destination network.

The following code snippet illustrates this process.

#include <cmapplicationsettingsui.h>

TCmSettingSelection userSelection;

CCmApplicationSettingsUi* settings = CCmApplicationSettingsUi::NewL();
CleanupStack::PushL( settings );

TUint listedItems = EShowAlwaysAsk | EShowDefaultConnection |
                    EShowDestinations | EShowConnectionMethods;

TBearerFilterArray filter;

settings->RunApplicationSettingsL( userSelection,
                                   listedItems,
                                   filter );
                                   
CleanupStack::PopAndDestroy( settings );

switch ( userSelection.iResult )
	{
	case EDestination:
	    {
        TConnSnapPref prefs;
        prefs.SetSnap( userSelection.iId );

        iConnection.Start( prefs, iStatus );
		break;
	    }
	case EConnectionMethod:
	    {
        TCommDbConnPref prefs;
        prefs.SetIapId( userSelection.iId );
        prefs.SetDialogPreference( ECommDbDialogPrefDoNotPrompt );

        iConnection.Start( prefs, iStatus );
	    break;
	    }
	case EDefaultConnection:
	    {
	    iConnection.Start( iStatus );
	    break;
	    }
	default: // EAlwaysAsk
	    {
        TCommDbConnPref prefs;
        prefs.SetDialogPreference( ECommDbDialogPrefPrompt );

        iConnection.Start( prefs, iStatus );
	    }
	}

SetActive();