Attempt to represent the S^2->S^3 header reorganisation as a series of "hg rename" operations
/*
* 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
* which accompanies this distribution, and is available
* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: Declaration of class CApDataHandler
*
*/
#ifndef APDATAHANDLER_H
#define APDATAHANDLER_H
// Deprecation warning
#warning This header file has been deprecated. Will be removed in one of the next SDK releases.
// INCLUDES
#include <commdb.h>
#include <etelmm.h>
#include <ApEngineVer.h>
#include <ApEngineConsts.h>
// FORWARD DECLARATIONS
class CApAccessPointItem;
class CApNetworkItem;
// extra data holder.
typedef struct
{
TInt iIsIpv6Supported; // Is Ipv6 Supported?
TBool iIsFeatureManagerInitialised;// Is FeatureManager Initialised?
/**
* Indicates if HSCSD Access point is supported or not.
*/
TBool iIsAppHscsdSupport;
TInt iVariant; /// Local variant value
}THandlerExtra;
// CLASS DECLARATION
/**
* Representation of the access point handler.
* Encapsulates a session with the CommsDB
* Provides a way to access the database and manipulate its data.
*/
class CApDataHandler :public CBase
{
public: // Constructors and destructor
/**
* Two-phased constructor. Leaves on failure, places instance
* on cleanup stack.
* @param aDb a reference to a CCommsDataBase object.
* @return The constructed CApDataHandler.
*
* @deprecated
*/
IMPORT_C static CApDataHandler* NewLC( CCommsDatabase& aDb );
/**
* Destructor.
*
* @deprecated
*/
IMPORT_C virtual ~CApDataHandler();
protected: // Constructors
/**
* C++ default constructor.
*
* @deprecated
*/
IMPORT_C CApDataHandler();
/**
* Second-phase constructor.
*
* @deprecated
*/
IMPORT_C void ConstructL( CCommsDatabase& aDb );
private:
public: // New functions
// query
/**
* Reads up one access point's data from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, function leaves with error code.
* <br>Error conditions:
* - Insufficient memory,
* - AP does not exists,
* - Server connection failure.
*
* @param aUid The Uid of the access point to be read
* @param aApItem A reference to a CApAccessPointItem to hold the data.
* @return no return value.
*
* @deprecated
*/
IMPORT_C void AccessPointDataL( TUint32 aUid,
CApAccessPointItem& aApItem );
// update
/**
* Updates data stored in an existing access point.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, no data is stored.
* <br>Error conditions:
* - Insufficient memory
* - Server connection failure
* - Lock already present by other task
* - Uid does not exists.
* - Attempting to update read-only records will result
* in KErrAccessDenied
*
* @param aApItem A reference to a CApAccessPointItem holding the data
* @param aNameChanged a reference to a TBool that will indicate
* whether the name has changed or not.
* @return No return value.
*
* @deprecated
*/
IMPORT_C void UpdateAccessPointDataL( CApAccessPointItem& aApItem,
TBool& aNameChanged );
// Creating new AP
/**
* Creates a copy of a previously existing access point.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, no access point will be created.
* <br>Error conditions:
* - Insufficient memory
* - Server connection failure.
* - Lock already present by other task.
* - Access point does not exist.
* - Attempting to create new in protected tables will results
* in KErrAccessDenied
*
* @param aBaseId The UID of the existing access point to copy from.
* @return The Uid of the newly constructed and saved access point.
*
* @deprecated
*/
IMPORT_C TUint32 CreateCopyFromL( TUint32 aBaseId );
/**
* Create a new access point from supplied data
* Expects that CApDataHandler has been created and the database had
* been opened.
* The name of the AP will be corrected to be unique if necessary and
* returned in the passed aApItem.
* In case of error, no access point will be created and the passed
* one will remain intact.
* <br>Error conditions:
* - Insufficient memory
* - Server connection failure.
* - Lock already present by other task.
* - Attempting to create new in protected tables will result
* in KErrAccessDenied
*
* @param aApItem Reference to a CApAccessPointItem holding the data
* @return The UID of the newly created and saved access point.
*
* @deprecated
*/
IMPORT_C TUint32 CreateFromDataL( CApAccessPointItem& aApItem );
// Remove
/**
* Removes the given access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* <br>Error conditions:
* - Insufficient memory,
* - Server connection failure.
* - Lock already present by other task.
* - Access point does not exist.
* - Attempting to remove read-only records will result
* in KErrAccessDenied
*
* @param aUid The UID of the access point to remove.
* @return no return value.
*
* @deprecated
*/
IMPORT_C void RemoveAPL( TUint32 aUid );
// Getting default access point
/**
* Reads the UID of the default access point.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* - Access point does not exists.
*
* @param aIsWAP A boolean indicating whether to read the default
* WAP or the default IAP/ISP (dep. on the database type) access point.
* @return The UID of the default access point.
*
* @deprecated
*/
IMPORT_C TUint32 DefaultL( TBool aIsWap ) const;
// Setting as default
/**
* Sets the default access point.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* - Access point does not exists.
* - Given Access Point is not of the desired type.
*
* @param aUid The UID of the access point to be set as default.
* @param aIntendedType The default type ( IAP, WAP, Both).
*
* @deprecated
*/
IMPORT_C void SetAsDefaultL(TUint32 aUid,
TCommsDbIspType aIntendedType );
// Setting preferences
/**
* Sets the access point preference. Can be used only if the
* database type is IAP.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* Can also leave with KErrAlreadyExists (if aOverWrite is EFalse ).
* @param aRank The ranking of the connection preference.
* @param aDircetion Specifies the direction of this connection
* preference
* @param aBearers The bearer set being valid for this connection
* preference
* @param aPrompt Enum value indicating whether or not the user
* should be prompted or warned on connection
* @param aIAP The identifier of the preferred IAP for this connection.
* @param aOverwrite Boolean value indicating that if a same record
* present, overwrite it or not.
*
* @deprecated
*/
IMPORT_C void SetPreferredIfDbIapTypeL
(
TUint32 aRank,
TCommDbConnectionDirection aDirection,
TUint32 aBearers,
TCommDbDialogPref aPrompt,
TUint32 aIAP,
TBool aOverwrite
);
/**
* Sets the access point preference. Can be used only if the
* database type is ISP.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* Can also leave with KErrAlreadyExists (if aOverWrite is EFalse ).
* @param aRank The ranking of the connection preference.
* @param aDircetion Specifies the direction of this connection
* preference
* @param aBearers The bearer set beeing valid for this connection
* preference
* @param aPrompt Enum value indicating whether or not the user
* should be prompted or warned on connection
* @param aISP The identifier of the preferred ISP for this connection.
* @param aChargeCard Identifier of the preferred chargecard for
* this connection.
* @param aServiceType The type of the service.
* @param aOverwrite Boolean value indicating that if a same record is
* present, overwrite it or not.
*
* @deprecated
*/
IMPORT_C void SetPreferredIfDbIspTypeL
(
TUint32 aRank,
TCommDbConnectionDirection aDirection,
TUint32 aBearers,
TCommDbDialogPref aPrompt,
TUint32 aISP,
TUint32 aChargeCard,
const TDesC& aServiceType,
TBool aOverwrite
);
/**
* Gets the access point preference. Can be used only if the
* database type is IAP.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* @param aRank The ranking of the desired connection preference.
* @param aDircetion Specifies the direction of the desired connection
* preference
* @param aBearers The bearer set beeing valid for this connection
* preference
* @param aPrompt Enum value indicating whether or not the user
* should be prompted or warned on connection
* @param aIAP The identifier of the preferred IAP for this
* connection preference.
*
* @deprecated
*/
IMPORT_C void GetPreferredIfDbIapTypeL
(
TUint32 aRank,
TCommDbConnectionDirection aDirection,
TUint32& aBearers,
TUint32& aPrompt,
TUint32& aIAP
);
/**
* Gets the access point preference. Can be used only if the
* database type is ISP.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* @param aRank The ranking of the desired connection preference.
* @param aDircetion Specifies the direction of the desired connection
* preference
* @param aBearers The bearer set beeing valid for this connection
* preference
* @param aPrompt Enum value indicating whether or not the user
* should be prompted or warned on connection
* @param aISP The identifier of the preferred ISP for this
* connection preference.
* @param aChargeCard Identifier of the preferred chargecard for
* this connection preference.
* @return The type of the service.
*
* @deprecated
*/
IMPORT_C const TDesC& GetPreferredIfDbIspTypeL
(
TUint32 aRank,
TCommDbConnectionDirection aDirection,
TUint32& aBearers,
TUint32& aPrompt,
TUint32& aISP,
TUint32& aChargeCard
);
// Getting default access point
/**
* Reads the UID of the default access point.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* - Access point does not exists.
*
* @param aIsWAP A boolean indicating whether to read the default
* WAP or the default IAP/ISP (dep. on the database type) access point.
* @param aReadOnly A TBool passed by reference to hold whether the
* the default access point record is read-only or not.
* @return The UID of the default access point.
*
* @deprecated
*/
IMPORT_C TUint32 DefaultL( TBool aIsWap, TBool& aReadOnly )const;
// Remove
/**
* Removes the given network group from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, network group will not be removed.
* <br>Error conditions:
* - Insufficient memory,
* - Server connection failure.
* - Lock already present by other task.
* - network group does not exist.
* - Attempting to remove read-only records will result
* in KErrAccessDenied
*
* @param aUid The UID of the network group to remove.
* @return no return value.
*
* @deprecated
*/
IMPORT_C void RemoveNetworkL( TUint32 aUid );
/**
* Creates a network group from the data.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, network group will not be created.
* <br>Error conditions:
* - Insufficient memory,
* - Server connection failure.
* - Lock already present by other task.
* - network group does not exist.
* - Attempting to remove read-only records will result
* in KErrAccessDenied
*
* @param aNetwork The network item to create/write into db.
* @return no return value.
*
* @deprecated
*/
IMPORT_C void CreateNetworkL( CApNetworkItem& aNetwork );
/**
* Reads up a network part of the access point
* Network is identified by the iNetworkId of the passed access point
*
* @deprecated
*/
IMPORT_C void ReadNetworkPartL( CApAccessPointItem& aItem );
/**
* Reads up a network
* Network is identified by passed uid
*
* @deprecated
*/
IMPORT_C void ReadNetworkL( TUint32 aUid, CApNetworkItem& aNetwork );
protected: // New functions
/**
* Reads the WAP part of the data from the database.
* In case of error, leaves with CommDb error codes.
* @param aWapId The UID of the Access Point to read the data from.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadWapDataL( TUint32 aWapId, CApAccessPointItem& aApItem );
/**
* Reads the IAP part of the data from the database.
* In case of error, leaves with CommDb error codes.
* @param aIapId The UID of the record in the IAP table to read
* the data.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadIapDataL( TUint32 aIapId, CApAccessPointItem& aApItem );
/**
* Reads the ISP part of the data from the database.
* In case of error, leaves with CommDb error codes.
* @param aIspId The UID of the record in the ISP table to
* read the data.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadIspDataL( TUint32 aIspId, CApAccessPointItem& aApItem );
/**
* Reads the GPRS data from the database.
* In case of error, leaves with CommDb error codes.
* @param aIspId The UID of the record in the GPRS table to
* read the data from.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadGprsDataL( TUint32 aIspId, CApAccessPointItem& aApItem );
/**
* Reads the CDMA data from the database.
* In case of error, leaves with CommDb error codes.
* @param aIspId The UID of the record in the CDMA table to
* read the data from.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadCdmaDataL( TUint32 aIspId, CApAccessPointItem& aApItem );
/**
* Reads the LAN data from the database.
* In case of error, leaves with CommDb error codes.
* @param aIspId The UID of the record in the LAN table to
* read the data from.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadLanDataL( TUint32 aIspId, CApAccessPointItem& aApItem );
/**
* Reads the DialIn/Out ISP data from the database.
* In case of error, leaves with CommDb error codes.
* @param aIspId The UID of the record in the Dialup table to
* read the data from.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadDialInOutDataL( TUint32 aIspId, CApAccessPointItem& aApItem );
/**
* Reads up the VPN bearer type info in case of a VPN access point
* In case of error, leaves with CommDb error codes.
* @param aIspId The UID of the record in the VPN table to
* read the data from.
* @param aApItem A reference to a CApAccessPointItem to hold the data
* @return No return value.
*/
void ReadVpnInfoL( TUint32 aIspId, CApAccessPointItem& aApItem);
/**
* Writes the WAP bearer part of the data to the database.
* In case of error, leaves with CommDb error codes.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aWapId The UID of the WAP Access Point record to update.
* Used only if aIsNew EFalse.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteWapBearerDataL
(
TBool aIsNew,
TUint32 aWapId,
CApAccessPointItem& aApItem
);
/**
* Writes the WAP AP part of the data to the database.
* In case of error, leaves with CommDb error codes.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aWapId The UID of the WAP Access Point record to update.
* Used only if aIsNew EFalse.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteWapApDataL
(
TBool aIsNew,
TUint32 aWapId,
CApAccessPointItem& aApItem
);
/**
* Writes the IAP part of the data to the database.
* In case of error, leaves with CommDb error codes.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aIapId The UID of the IAP Access Point record to update.
* Used only if aIsNew EFalse.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteIapDataL
(
TBool aIsNew,
TUint32 aIapId,
CApAccessPointItem& aApItem
);
/**
* Writes the ISP part of the data to the database.
* In case of error, leaves with CommDb error codes.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aIspId The UID of the ISP Access Point record to update.
* Used only if aIsNew EFalse.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteIspDataL( TBool aIsNew, TUint32 aIspId,
CApAccessPointItem& aApItem );
/**
* Writes the Cdma data to the database.
* In case of error, leaves with CommDb error codes.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteCdmaDataL( TBool aIsNew,
CApAccessPointItem& aApItem );
/**
* Writes the Gprs data to the database.
* In case of error, leaves with CommDb error codes.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteGprsDataL( TBool aIsNew,
CApAccessPointItem& aApItem );
/**
* Writes the LAN data to the database.
* In case of error, leaves with CommDb error codes.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteLanDataL( TBool aIsNew,
CApAccessPointItem& aApItem );
/**
* Writes the data to the database.
* In case of error, leaves with CommDb error codes.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @return No return value.
*/
TUint32 DoUpdateAccessPointDataL( CApAccessPointItem& aApItem,
TBool aIsNew, TBool& aNameChanged );
/**
* Sets the default IAP & ISP records in Global Settings.
* In case of error, leaves with CommDb error codes.
* @param aApItem A UID to the WAP Access Point record to
* be used as a default.
* @return No return value.
*/
void SetDefaultIapIspL( TUint32 aUid );
// Remove
/**
* Removes the WAP_BEARER table part of the access point from
* the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the access point to remove.
* @return No return value.
*/
void RemoveWapBearerApL( TUint32 aUid );
/**
* Removes the WAP_ACCESS_POINT table part of the access point from
* the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the access point to remove.
* @return No return value.
*/
void RemoveWapApL( TUint32 aUid );
/**
* Removes the IAP part of the access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the IAP part of the access point to remove.
* @return No return value.
*/
void RemoveIapL( TUint32 aUid );
/**
* Removes the ISP part of the access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the ISP part of the access point to remove.
* @param aOut TBool indicating whether Dial out or dial in ISP.
* @return No return value.
*/
void RemoveIspL( TUint32 aUid, TBool aOut );
/**
* Removes the GPRS part of the access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the GPRS part of the access point to remove.
* @return No return value.
*/
void RemoveGprsL( TUint32 aUid, TBool aOut );
/**
* Removes the CDMA part of the access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the CDMA part of the access point to remove.
* @return No return value.
*/
void RemoveCdmaL( TUint32 aUid );
/**
* Removes the LAN part of the access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the LAN part of the access point to remove.
* @return No return value.
*/
void RemoveLanL( TUint32 aUid );
/**
* Removes the WLAN part of the access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* @param aUid The UID of the LAN part of the access point to remove.
* @return No return value.
*/
void RemoveWlanL( TUint32 aUid );
/**
* Handles the bearer change related things (deleting old links,
* inserting new ones if needed in the database).
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point data will not be changed.
* @param aApItem A reference to a CApAccessPointItem holding the
* CHANGED data.
* @return Boolean indicating whether bearer has changed or not.
*/
TBool HandleBearerChangeIfNeededL( CApAccessPointItem& aApItem );
/**
* Reads up one access point's data from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, function leaves with error code.
* <br>Error conditions:
* - Insufficient memory,
* - AP does not exists,
* - Server connection failure.
*
* @param aUid The Uid of the access point to be read
* @param aApItem A reference to a CApAccessPointItem to hold the data.
* @return no return value.
*/
void DoAccessPointDataL( TUint32 aUid, CApAccessPointItem& aApItem );
/**
* Removes the given access point from the database.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, access point will not be removed.
* <br>Error conditions:
* - Insufficient memory,
* - Server connection failure.
* - Lock already present by other task.
* - Access point does not exist.
* - Attempting to remove read-only records will result
* in KErrAccessDenied
*
* @param aUid The UID of the access point to remove.
* @return no return value.
*/
void DoRemoveAPL( TUint32 aUid );
/**
* Sets the default access point.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* - Access point does not exists.
* - Given Access Point is not of the desired type.
*
* @param aUid The UID of the access point to be set as default.
* @param aIntendedType The default type ( IAP, WAP, Both).
*/
void DoSetAsDefaultL(TUint32 aUid, TCommsDbIspType aIntendedType );
/**
* Sets the access point preference. Can be used only if the
* database type is IAP.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* Can also leave with KErrAlreadyExists (if aOverWrite is EFalse ).
* @param aRank The ranking of the connection preference.
* @param aDircetion Specifies the direction of this connection
* preference
* @param aBearers The bearer set beeing valid for this connection
* preference
* @param aPrompt Enum value indicating whether or not the user
* should be prompted or warned on connection
* @param aIAP The identifier of the preferred IAP for this connection.
* @param aOverwrite Boolean value indicating that if a same record
* present, overwrite it or not.
*/
void DoSetPreferredIfDbIapTypeL
(
TUint32 aRank,
TCommDbConnectionDirection aDirection,
TUint32 aBearers,
TCommDbDialogPref aPrompt,
TUint32 aIAP,
TBool aOverwrite
);
/**
* Sets the access point preference. Can be used only if the
* database type is ISP.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* Can also leave with KErrAlreadyExists (if aOverWrite is EFalse ).
* @param aRank The ranking of the connection preference.
* @param aDircetion Specifies the direction of this connection
* preference
* @param aBearers The bearer set beeing valid for this connection
* preference
* @param aPrompt Enum value indicating whether or not the user
* should be prompted or warned on connection
* @param aISP The identifier of the preferred ISP for this connection.
* @param aChargeCard Identifier of the preferred chargecard for
* this connection.
* @param aServiceType The type of the service.
* @param aOverwrite Boolean value indicating that if a same record
* present, overwrite it or not.
*/
void DoSetPreferredIfDbIspTypeL
(
TUint32 aRank,
TCommDbConnectionDirection aDirection,
TUint32 aBearers,
TCommDbDialogPref aPrompt,
TUint32 aISP,
TUint32 aChargeCard,
const TDesC& aServiceType,
TBool aOverwrite
);
/**
* Converts setted AP speed from TApCallSpeed to commsdb values
* @param The access point item whose speed needs to be converted
* @return no return value
*/
/*****************************************************
* Series 60 Customer / ETel
* Series 60 ETel API
*****************************************************/
void ApSpeed2EtelL( CApAccessPointItem* aItem );
/**
* Converts commsdb speed values to TApCallSpeed
* @param The access point item whose speed needs to be converted
* @return no return value
*/
/*****************************************************
* Series 60 Customer / ETel
* Series 60 ETel API
*****************************************************/
void EtelSpeed2ApL( CApAccessPointItem& aItem );
// Getting default access point
/**
* Reads the UID of the default access point.
* Expects that CApDataHandler has been created and the database had
* been opened.
* In case of error, leaves with CommsDb or system error codes.
* <br>Error conditions:
* - Insufficient memory;
* - Server connection failure;
* - Lock already present;
* - Access point does not exists.
*
* @param aIsWAP A boolean indicating whether to read the default
* WAP or the default IAP/ISP (dep. on the database type) access point.
* @param TBool*: if not NULL, a holder for the read-only flag of
* the default access point. Prepared for future products but also used
* here through passing NULL ptr.
* @return The UID of the default access point.
*/
TUint32 DoGetDefaultL( TBool aIsWap, TBool* aReadOnly ) const;
/**
* Writes the proxy data of an access point
* @param aIsNew Boolean stating whether the access point is new
* @param aApItem A CApAccessPointItem passed by reference
* holding the current access point data. It's record ID's will be
* updated if needed (in case it is a new item )
*/
void WriteProxyDataL( TBool aIsNew,
const CApAccessPointItem& aApItem );
/**
* Reads up the proxy data of an access point
* @param aApItem A CApAccessPointItem passed by reference
* holding the current access point data.
*/
void ReadProxyDataL( CApAccessPointItem& aApItem );
/**
* Removes a proxy data
* @param aServiceType The service type to remove for
* @param aIspId The service record ID
*/
void RemoveProxyDataL( HBufC* aServiceType, TUint32 aIspId );
/**
* Writes the network data of an access point
* @param aIsNew Boolean stating whether the access point is new
* @param aApItem A CApAccessPointItem passed by reference
* holding the current access point data. It's record ID's will be
* updated if needed (in case it is a new item )
*/
void WriteNetworkDataL( TBool aIsNew, CApAccessPointItem& aApItem );
/**
* Reads up the network data of an access point
* @param aApItem A CApAccessPointItem passed by reference
* holding the current access point data.
*/
void ReadNetworkDataL( CApAccessPointItem& aApItem );
/**
* Removes the network data
* @param aIspId The record ID to remove
*/
void RemoveNetworkDataL( TUint32 aIspId );
/**
* Gets the location record ID
* @return The UID of the location.
*/
TUint32 GetLocationIdL();
/**
* Gets the modem record ID
* @return The UID of the modem record.
*/
TUint32 GetModemBearerIDL( CApAccessPointItem& aApItem );
/**
* Returns the protocol for the passed item
* @param aApItem An access point item
* @return The protocol of the passed item.
*/
TUint32 ProtocolL( CApAccessPointItem& aApItem );
/**
* Returns the commsdb speed for the passed item
* @param aApItem An access point item
* @return The speed of the passed item.
*/
TUint32 CommsDbSpeedL( CApAccessPointItem& aApItem );
/**
* Reads up common IP & PPP SERVICE data parts of an access point.
* Leaves if it is not persent in the database
* @param The table to read from
* @param The CApAccessPointItem to store into
*/
void ReadServiceL( CCommsDbTableView& ispt,
CApAccessPointItem& aApItem );
/**
* Reads up CSD/GPRS IPv6 parts of an access point.
* Leaves if it is not persent in the database
* @param The table to read from
* @param The CApAccessPointItem to store into
*/
void ReadServiceIp6L( CCommsDbTableView& ispt,
CApAccessPointItem& aApItem );
/**
* Writes common IP & PPP SERVICE data parts of an access point.
* Leaves if it is not persent in the database
* @param The table to write into
* @param The CApAccessPointItem holding the data to store
*/
void WriteServiceL( CCommsDbTableView& aTable,
CApAccessPointItem& aApItem );
/**
* Writes the IPv6 parts of an access point.
* Leaves if it is not persent in the database
* @param The table to write to
* @param The CApAccessPointItem to read the data from
*/
void WriteServiceIp6L( CCommsDbTableView& ispt,
CApAccessPointItem& aApItem );
/**
* Writes the CSD isp data to the database.
* In case of error, leaves with CommDb error codes.
* Leaves with KErrNotSupported if (HS)CSD bearer type is not supported.
* @param aIsNew A Boolean indicating whether it is a new record or it
* is an update operation.
* @param aApItem Reference to a CApAccessPointItem which holds the data
* @return No return value.
*/
void WriteCsdDataL( TBool aIsNew, CApAccessPointItem& aApItem );
/**
* Gets the local variant value
* @return A TInt stating the variant
*/
// TInt GetVariantL();
/**
* Reads up WLAN data parts of an access point.
* Leaves if it is not persent in the database
* @param The table to read from
* @param The CApAccessPointItem to store into
*/
void ReadWlanL( CCommsDbTableView& lant,
CApAccessPointItem& aApItem );
/**
* Writes the WLAN parts of an access point.
* Leaves if it is not persent in the database
* @param The table to write to
* @param The CApAccessPointItem to read the data from
*/
void WriteWlanL( CCommsDbTableView& aTable,
CApAccessPointItem& aApItem );
/**
* Creates a new record in the LANBearer table if there is none for WLAN
* @return The UID of the LANBEarer record.
*/
TUint32 CreateLanBearerIfNeededL();
/**
* Reads up the name of the LAN/Modem bearer record
*/
void ReadModemBearerNameL( CApAccessPointItem& aApItem );
private: // Data
CCommsDatabase* iDb;
// TCommDbDatabaseType iDbType; // deprecated and not used but kept
// to maintain class size for BC
// no change in size as deprecated removed,
// new added, with the same size...
THandlerExtra* iExt;
};
#endif // APDATAHANDLER_H
// End of File