/*
* Copyright (c) 2002 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:
* MPsetNetworkSelect defines interface to get network information and
* select network. MPsetNetworkInfoObserver is used to handle completion
* of function calls of this class. All the methods are asynchronous.
* Observer handles completion
*
*
*/
#ifndef MPSETNETWORKSELECT_H
#define MPSETNETWORKSELECT_H
// INCLUDES
#include <e32base.h>
// FORWARD DECLARATIONS
class MPsetNetworkInfoObserver;
// CLASS DEFINITIONS
/**
* MPsetNetworkSelect class is virtual class for network selection.
* @lib phonesettings.lib
* @since 1.0
*/
class MPsetNetworkSelect
{
public:
//Length of codes (MNC and MCC)
enum
{
EPSetNetMcc = 4,
EPSetNetMnc = 8
};
//TNetworkId contains network ID and country ID
struct TNetworkId
{
TBuf<EPSetNetMcc> iCountryCode;
TBuf<EPSetNetMnc> iNetworkCode;
};
//Length of network names
enum
{
ENetShortNameSize = 20,
ENetLongNameSize = 30
};
//Network selection mode
enum TSelectMode
{
ENetSelectModeAutomatic,
ENetSelectModeManual
};
//Status of network
enum TNetworkStatus
{
ENetStatUnknown,
ENetStatAvailable,
ENetStatCurrent,
ENetStatForbidden
};
//Network access type
enum TNetworkAccess
{
ENetNetworkGSM,
ENetNetworkWCDMA
};
//Information about network
struct TNetworkInfo
{
TNetworkId iId;
TNetworkStatus iStatus;
TSelectMode iMode;
TNetworkAccess iAccess;
TBuf<ENetShortNameSize> iShortName;
TBuf<ENetLongNameSize> iLongName;
};
//Current status of the network
enum TCurrentNetworkStatus
{
ENotRegisteredNotSearching,
ERegisteredOnHomeNetwork,
ENotRegisteredSearching,
ERegistrationDenied,
EUnknown,
ERegisteredRoaming
};
//Current information about the network
struct TCurrentNetworkInfo
{
TCurrentNetworkStatus iStatus;
TUint iLocationAreaCode;
TUint iCellId;
};
public:
/**
* Puts network retrieve results into array.
*
*/
virtual void GetAvailableNetworksL() = 0;
/**
* Returns current network information.
*
* @param aInfo Current network information
* @return Returns error code.
*/
virtual TInt GetCurrentNetworkInfo(
MPsetNetworkSelect::TCurrentNetworkInfo& aInfo ) = 0;
/**
* Returns current network selection mode.
*
* @param aMode Network selection mode
* @return Returns error code.
*/
virtual TInt GetNetworkSelectMode( TSelectMode& aMode) = 0;
/**
* Sets network, also for selecting automatic/manual mode.
*
* @param aInfo Network information
*/
virtual void SelectNetworkL( const TNetworkInfo& aInfo ) = 0;
/**
* CancelProcess-function, cancels the requests.
*/
virtual void CancelProcess() = 0;
};
#endif // MPSETNETWORKSELECT_H
// end of file