epoc32/include/mw/cmgenconnsettings.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h) This is the epoc32/include tree with the "platform" subtrees removed, and all but a selected few mbg and rsg files removed.

/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "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:
*
* Description:  General connectivity settings.
*
*/
#ifndef CMGENCONNSETTINGS_H
#define CMGENCONNSETTINGS_H


// Usage types for WLAN
enum TCmUsageOfWlan
    {
    // Known WLANs will be used, and they will be switched to
    // if they become available during existing connections.
    ECmUsageOfWlanKnown,
    // Known and new WLANs will be used. 
    ECmUsageOfWlanKnownAndNew, 
    // WLANs will be used but they will not be switched to
    // from existing connections.
    ECmUsageOfWlanManual   
    };

// Cellular data usage values
enum TCmCellularDataUsage
    {
    // Cellular data connection is not used automatically but a confirmation
    // is requested from the user.
    ECmCellularDataUsageConfirm,
    // Cellular data connection is automatically used without querying
    // permission from the user.
    ECmCellularDataUsageAutomatic,
    // Cellular data usage is disabled. Only WLAN will be used.
    ECmCellularDataUsageDisabled
    };

// DEPRECATED enumeration which will be removed within few weeks.
// DO NOT USE THESE VALUES.
// Functionality related to these values is broken although it compiles.
enum TCmSeamlessnessValue
        {
        ECmSeamlessnessNotRoamedTo,   // DO NOT USE
        ECmSeamlessnessConfirmFirst,  // DO NOT USE
        ECmSeamlessnessShowprogress,  // DO NOT USE
        ECmSeamlessnessFullySeamless, // DO NOT USE
        ECmSeamlessnessDisabled       // DO NOT USE
        };

// Table for connection settings other than default connection
struct TCmGenConnSettings
    {
    // WLAN usage.
    TCmUsageOfWlan         iUsageOfWlan;
    // Cellular data usage in home country.
    TCmCellularDataUsage   iCellularDataUsageHome;
    // Cellular data usage abroad.
    TCmCellularDataUsage   iCellularDataUsageVisitor;

    // DEPRECATED variable that will be removed within few weeks.
    // DO NOT USE THESE VARIABLES.
    // Functionality related to this variable is broken although it compiles.
    TCmSeamlessnessValue   iSeamlessnessHome;
    // DEPRECATED variable that will be removed within few weeks.
    // DO NOT USE THESE VARIABLES.
    // Functionality related to this variable is broken although it compiles.
    TCmSeamlessnessValue   iSeamlessnessVisitor;
    };

#endif