// Copyright (c) 2001-2009 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:

// ETel Multimode Packet Data API 

// MBMS Broadcast,GPRS Release 97/98, CDMAOne, CDMA2000, Release 99 and Release 4.

// 

//

#if !defined(__ETELPCKT_H__)

#define __ETELPCKT_H__

#include <e32base.h>

#include <s32mem.h>

#include <etel.h>

#include <cdblen.h>

#include <exterror.h>

#include <etelutils.h>

#include <mbmstypes.h>

//

//  Global constants and types

// 

// General

// Passed into RTelServer::IsSupportedByModule()

/**

Unique Packet Data API Identifier for Packet API version 1.0.

@publishedPartner

@released

*/

const TInt KETelExtPcktV1 = 4000;	

/**

Unique Packet Data API Identifier for Packet API version 2.0.

@publishedPartner

@released

*/

const TInt KETelExtPcktV2 = 8000;	 

/**

Unique Packet Data API Identifier for Packet API version 3.0.

aka 3GPP Release 5 support

@publishedPartner

@released

*/

const TInt KETelExtPcktV3 = 12000;	 

// GPRS-specific causes for Session Management (Annex I, 3GPP TS 24.008)

/** This cause is sent to the MS if it requests an IMSI attachment for GPRS services, 

but is not allowed to operate GPRS services.  

@publishedPartner

@released

*/

const TInt KErrGprsServicesNotAllowed=KErrGsmMobilityManagementBase-7;

/** This cause is sent to the MS if it requests a combined IMSI attach for GPRS 

and non-GPRS services, but is not allowed to operate either of them. 

@publishedPartner

@released

*/

const TInt KErrGprsAndNonGprsServicesNotAllowed=KErrGsmMobilityManagementBase-8;

/** This cause is sent to the MS when the network cannot derive the MS's identity 

from the P-TMSI in case of an inter-SGSN routing area update.  

@publishedPartner

@released

*/

const TInt KErrGprsMSIdentityCannotBeDerivedByTheNetwork=KErrGsmMobilityManagementBase-9;

/** This cause is sent to the MS either if the network has implicitly detached 

the MS, e.g. some while after the Mobile reachable timer has expired, or if 

the GMM context data relating to the subscription does not exist in the SGSN, 

e.g. because of a SGSN restart.  

@publishedPartner

@released

*/

const TInt KErrGprsMSImplicitlyDetached=KErrGsmMobilityManagementBase-10;

/** This cause is sent to the MS if it requests a combined GPRS attachment or routing 

is updating in a PLMN where the MSC is temporarily not reachable via the GPRS 

part of the GSM network.  

@publishedPartner

@released

*/

const TInt KErrGprsMSCTemporarilyNotReachable=KErrGsmMobilityManagementBase-16;

/** The PDP context is deactivated because of a LLC or SNDCP failure.  

@publishedPartner

@released

*/

const TInt KErrGprsLlcOrSndcpFailure=KErrGsmMobilityManagementBase-25;

/** Insufficient GPRS resources are available for the request to complete successfully.  

@publishedPartner

@released

*/

const TInt KErrGprsInsufficientResources=KErrGsmMobilityManagementBase-26;

/** Access Point Name is either missing from the Activation request or is unknown.  

@publishedPartner

@released

*/

const TInt KErrGprsMissingorUnknownAPN=KErrGsmMobilityManagementBase-27;

/** The PDP address supplied with the Activation request is unknown.  

@publishedPartner

@released

*/

const TInt KErrGprsUnknownPDPAddress=KErrGsmMobilityManagementBase-28;

/** User authentication has failed.  

@publishedPartner

@released

*/

const TInt KErrGprsUserAuthenticationFailure=KErrGsmMobilityManagementBase-29;

/** The GGSN has rejected the activation request for some reason.  

@publishedPartner

@released

*/

const TInt KErrGprsActivationRejectedByGGSN=KErrGsmMobilityManagementBase-30;

/** The activation request has been rejected for an unspecified reason.  

@publishedPartner

@released

*/

const TInt KErrGprsActivationRejected=KErrGsmMobilityManagementBase-31;

/** The requested service is not supported by the PLMN.

@publishedPartner

@released

*/

const TInt KErrGprsServiceOptionNotSupported=KErrGsmMobilityManagementBase-32;

/** There is no active subscription to the requested service.

@publishedPartner

@released

*/

const TInt KErrGprsRequestedServiceOptionNotSubscribed=KErrGsmMobilityManagementBase-33;

/** The service is temporarily out of order.

@publishedPartner

@released

*/

const TInt KErrGprsServiceOptionTemporarilyOutOfOrder=KErrGsmMobilityManagementBase-34;

/** The NSAPI supplied with the activation request is not unique.  

@publishedPartner

@released

*/

const TInt KErrGprsNSAPIAlreadyUsed=KErrGsmMobilityManagementBase-35;

/** The context has been deactivated successfully.  

@publishedPartner

@released

*/

const TInt KErrGprsRegularContextDeactivation=KErrGsmMobilityManagementBase-36;

/** The Quality of Service requested has not been accepted.  

@publishedPartner

@released

*/

const TInt KErrGprsQoSNotAccepted=KErrGsmMobilityManagementBase-37;	

/** The GPRS network is requesting reactivation of a context.  

@publishedPartner

@released

*/

const TInt KErrGprsReactivationRequested=KErrGsmMobilityManagementBase-39;

/** The feature is not supported.  

@publishedPartner

@released

*/

const TInt KErrGprsFeatureNotSupported=KErrGsmMobilityManagementBase-40;

/** There is a semantic error in the TFT operation.

@publishedPartner

@released

*/

const TInt KErrGprsSemanticErrorInTFTOperation=KErrGsmMobilityManagementBase-41;

/** There is a syntactical error in the TFT operation.

@publishedPartner

@released

*/

const TInt KErrGprsSyntacticalErrorInTFTOperation=KErrGsmMobilityManagementBase-42;

/** The PDP context activation request is not active. 

@publishedPartner

@released

*/

const TInt KErrGprsUnknownPDPContext=KErrGsmMobilityManagementBase-43;

/** There is one or more semantic errors in packet filter(s) of the TFT.

@publishedPartner

@released

*/

const TInt KErrGprsSemanticErrorsInPacketFilters=KErrGsmMobilityManagementBase-44;

/** There is one or more syntactical errors in packet filter(s) of the TFT.

@publishedPartner

@released

*/

const TInt KErrGprsSyntacticalErrorInPacketFilters=KErrGsmMobilityManagementBase-45;

/** The GPRS network has already activated a PDP context without TFT.

@publishedPartner

@released

*/

const TInt KErrGprsPDPContextWithoutTFTAlreadyActivated=KErrGsmMobilityManagementBase-46;

// UMTS-specific cause values for Call control (Annex H, 3GPP TS 24.008)

/** QoS not available.

@publishedPartner

@released

*/

const TInt KErrUmtsQoSNotAvailable=KErrGsmMobilityManagementBase-49;

/** Maximum number of PDP contexts supported by phone exceeded.  

@publishedPartner

@released

*/

const TInt KErrUmtsMaxNumOfContextExceededByPhone=KErrGsmMobilityManagementBase-50;

/** Maximum number of PDP contexts supported by the network exceeded.  

@publishedPartner

@released

*/

const TInt KErrUmtsMaxNumOfContextExceededByNetwork=KErrGsmMobilityManagementBase-51;

/** Phone is in offline mode.  

@publishedPartner

@released

*/

const TInt KErrGprsOfflineMode=KErrGsmMobilityManagementBase-52;

/** 

 * MBMS network support does not exist.

 * @publishedPartner

 * @released

 */

const TInt KErrMbmsNotSupported=KErrGsmMobilityManagementBase-53;

/**

 * Specific MBMS service is not available.  

 * @publishedPartner

 * @released

 */

const TInt KErrMbmsServiceUnavailable=KErrGsmMobilityManagementBase-54;

/**

 * Preempts low priority MBMS/Non-MBMS service.  

 * @publishedPartner

 * @released

 */

const TInt KErrMbmsServicePreempted=KErrGsmMobilityManagementBase-55;

/**

 * One or more invalid MBMS service entry supplied.  

 * @publishedPartner

 * @released

 */

const TInt KErrMbmsImpreciseServiceEntries=KErrGsmMobilityManagementBase-56;

class TPacketDataConfigBase 

/** Base class for the packet configuration classes.

The Context configuration, QoS profile (Requested and Negotiated) and QoS 

Capabilities classes inherit from this class. It is outside the scope of all 

the Packet data classes. 

To allow future configuration structures (e.g. TContextConfigWCDMA, 

TContextConfigPDC, etc.) to be added in such a way that a completely different 

structure may be defined and passed into the same functions as this one, all 

existing configuration structures are derived from this thin base class 

which provides just one function, ExtensionId(). This function returns the 

one protected member variable, iExtensionId. A new structure would define an 

associated new constant to be set in iExtensionId on construction, which would 

then be queried by the TSY prior to unpackaging the structure. 

@see RPacketContext::TContextConfigCDMA 

@see RPacketContext::TContextConfigR99_R4  

@see RPacketContext::TContextConfig_R5

@see RPacketContext::TContextConfigMbmsV1

@publishedPartner

@released

*/

	{

public:

	/**

	Flags identifying the different packet networks.

	*/

	enum 

		{

		/**

		GPRS Release 97/98 packet network.

		*/

		KConfigGPRS= 0x01,				

		/**

		CDMA and CDMA2000 packet networks.

		*/

		KConfigCDMA = 0x02,		

		/**

		GPRS/UMTS Release 99 and UMTS Release 4 networks.

		*/ 

		KConfigRel99Rel4 = 0x04,

		/**

		UMTS/IMS 3GPP Release 5 networks.

		*/ 

		KConfigRel5 = 0x05,	

		/**

		MBMS networks

		*/

		KConfigMBMS = 0x06		

		};

	/** This member returns the type of class.

	@return The type of class. */

	inline TInt ExtensionId(){return iExtensionId;};

protected:

	/**

	Defines the type of class: either KConfigGPRS, KConfigCDMA or KConfigRel99Rel4,

	which identifies the type of packet network (GPRS R97/98, CDMA, Release 99 or 4 or 5)

	*/

	TInt iExtensionId;	

	};

class TConnectionInfoBase 

/** Base class for the configuration info classes. It is outside the scope of 

all the Packet data classes. 

To allow future connection information structures (e.g. TConnectionInfoV2, 

TConnectionInfoV3, etc.) to be added and as a result information carried by the 

structure can be increased. All information structures are derived from this 

thin base class which provides just one function, ExtensionId(). This function 

returns the protected member variable, iExtensionId. A new structure would 

define an associated new constant to be set in iExtensionId on construction, 

which would then be queried by the TSY prior to unpackaging the structure. 

@see RPacketContext::TConnectionInfoV1

@publishedPartner

@released

*/

	{

public:

	/**

	Flags identifying the different connection information structures

	*/

	enum 

		{

		/**

		Connection information version 1.

		*/

		KConnectionInfoV1 = 0x01

		};

	/** Return the type of class.

	*

	@return The version of class. 

	*/

	inline TInt ExtensionId(){return iExtensionId;};

public:

	/** A bit-wise sum of TConnectionInfoFlags indicating which of the optional 

	fields contain valid data. */

    TUint32 iValid;        	

protected:

	/** Defines the type of class. */

	TInt iExtensionId;	

	};

class TPacketBase

/** 

Base class for the Packet data ETel API parameters which are version dependent

(version 2 onwards). Note that even though the 7.0 version of the API does not define

version dependent classes, this implementation HAS been employed in the v7.0S version

(V2.0) of the API.

The TPacketBase::ExtensionId() method is used to determine which version of a packaged

parameter has been created. 

Note that the TPacketDataConfigBase::ExtensionId() method returns a packet network 

type.

@publishedPartner

@released

*/

	{

public:

	IMPORT_C TInt ExtensionId() const;

protected:

	TPacketBase();

	TInt iExtensionId;					///< Extension identifier

	};

class TPacketType

/**

Base class for all the V1 parameter types.

@publishedPartner

@released

*/

{

public:

	IMPORT_C TInt ExtensionId() const;

protected:

	TPacketType();

	void InternalizeL(RReadStream& aStream);

	void ExternalizeL(RWriteStream& aStream) const;

protected:

	TInt iExtensionId;

};

struct TClientId

/**Holds the session and subsession handles which would be used  

within the 2-phase list retrieval mechanism. During both the phases, 

the client-side API code will pass down the TClientId so that TSY can use

this information to match the first phase of the request to the second phase. */

	{

	/** The handle to the underlying RTelServer session. */

	TInt iSessionHandle;

	/** The handle to the sub-session to which this API request relates. */

	TInt iSubSessionHandle;

	};	

class RPacketService;

class CPacketContextPtrHolder;

class RPacketContext : public RTelSubSessionBase

/** Defines the context and the configuration of a connection to the network's 

packet-switched service. 

The functionality associated with the context of a packet-switched connection 

(configuring, modifying, activating, etc) are encapsulated within this class.

Each instance of this class has an RPacketService parent, to which it belongs.

@publishedPartner

@released

*/

	{

public:

	IMPORT_C RPacketContext();

	IMPORT_C TInt OpenNewContext(RPacketService& aPacketNetwork, TDes& aContextName);	

	IMPORT_C TInt OpenExistingContext(RPacketService& aPacketNetwork,const TDesC& aContextName);	

	IMPORT_C void Close();

// 

//	Nested classes dealing with context configurations for each network type

//

	enum {KGSNNameLength = 252};	// 3GPP TS 24.008, section 10.5.6.1 gives a range of 3 - 102 octets for the APN. 252 has been chosen as an adequate value for practical purposes.

	enum {KMaxPDPAddressLength = KCommsDbSvrMaxFieldLength}; 

	enum 

		{

		KPdpDataCompression		= 0x01,

		KPdpHeaderCompression	= 0x02

		};

/** Buffer to hold the GSN address.

@see KGSNNameLength */

	typedef TBuf8<KGSNNameLength> TGSNAddress;				///< GPRS Support Node (GSN) name

/** Buffer to hold the protocol address.

@see KMaxPDPAddressLength */

	typedef TBuf8<KMaxPDPAddressLength> TProtocolAddress;	///< GPRS Rel97/98, CDMA, Rel99 and Rel4.

	//

	// TProtocolType - defines the protocol used to connect to the packet data gateway

	// 

/** Defines the protocol used to connect to the packet data gateway.

Modes: GRPS */

	enum TProtocolType

		{

	/** IPv4 type gateway.

	Modes: GRPS */

		EPdpTypeIPv4,	

	/** IPv6 type gateway.

	Modes: GPRS */

		EPdpTypeIPv6,	

	/** X.25 type gateway.

	Modes: GPRS */

		EPdpTypeX25,	

	/** PPP type gateway.

	Modes: GRPS, CDMA */

		EPdpTypePPP,	

	/** CDPD type gateway.

	Modes: CDMA */

		EPdpTypeCDPD

		};

	//

	// TServiceOption - service option numbers are CDMA specific and used in the API to 

	// identify the various packet data services available on the CDMA packet network.

	// 

/** Service option numbers identify the various packet data services available 

on the CDMA packet network.

Modes: CDMA */

	enum TServiceOption

		{

	/** Service Options 7 and 15, 8-16. */

		KLowSpeedData		   = 0x01,	

	/** Service Options 22-25 IP and 26-29 CDPD. */

		KHighSpeedData	 	   = 0x02,	

	/** Service Option 33 on CDMA2000 network only. */

		KHighSpeedCDMA2000Data = 0x04	

		};

	/** Anonymous access required.

	Modes: GRPS, CDMA */

	enum TAnonymousAccess

		{

	/** Anonymous access not applicable.

	Modes: GRPS, CDMA */

		ENotApplicable,

	/** Anonymous access required.

	Modes: GRPS */

		ERequired,		

	/** Anonymous access not required.

	Modes: GPRS */

		ENotRequired	

		};

	enum { KMaxAuthDataLength = 50 };

	/** Buffer for various sorts of authorisation data since version 2 of the API.

	Supported from v7.0S.

	*/

	typedef TBuf8<KMaxAuthDataLength> TAuthData;

	//

	// TAuthProtocol - this enables the client to set the protocol type used on the context

	// 

	enum TAuthProtocol

        {

        EProtocolNone,

        EProtocolPAP,

        EProtocolCHAP

        };

	//

	// TAuthInfo - this enables the client to set the authentication data used on the context

	//

	struct TAuthInfo

		{

		TAuthProtocol iProtocol;

        TAuthData iUsername;

        TAuthData iPassword;

		};

	//

	// TDnsInfoV2 - this class enables the client to set the primary and secondary DNS server

	// names used on the context 

	//

	class TDnsInfoV2 : public TPacketBase

	/**

	Enables the client to set the primary and secondary DNS server

	names used on the context since version 2 of the API.

	Supported from v7.0S.

	@publishedPartner

	@released

	*/

		{

	public:

		IMPORT_C TDnsInfoV2();

	public:

		/** Primary DNS server name.*/

		TProtocolAddress iPrimaryDns;

		/** Secondary DNS server name.*/

		TProtocolAddress iSecondaryDns;

		};

	/**

	DNS information package since version 2 of the API.

	Supported from v7.0S.

	*/

	typedef TPckg<TDnsInfoV2> TTDnsInfoV2Pckg;

	//

	//  - this buffer can be used to store protocol related data

	// (such as "PPP config options") which do not fit into the other fields of the

	// TProtocolConfigOptionV2 class (see below).  The length of the buffer is based on

	// the previous buffer used (before TProtocolConfigOptionV2 was implemented), which 

	// was based on 3GPP TS 24.008 (253 octets).

	//

	enum {KMiscProtocolBufferLength = 253};

	typedef TBuf8<KMiscProtocolBufferLength> TMiscProtocolBuffer;

	class TProtocolConfigOptionV2 : public TPacketBase

	/**

	Holds authentication data encapsulated in TAuthInfo, as 

	well as further data that may be required for CHAP protocol 

	authentication, such a challenge and response, since version

	2 of the API.

	Can contain the DNS server names, the username, password, 

	and CHAP associated data.

	Normal authentication uses only TAuthInfo::iUsername and 

	TAuthInfo::iPassword. The other parameters are for secure 

	authentication. 

	The maximum combined length of the TAuthInfo::iUsername 

	and the secure information (iPassword or iResponse) is 50 bytes.

	Rather than keep the Protocol Config Option as a buffer it 

	is encapsulated as a class. This enables data extraction to 

	occur easily.

	Supported from v7.0S. 

	@publishedPartner

	@released

	*/

		{

	public:

		IMPORT_C TProtocolConfigOptionV2();

	public:

		/** Authentication data.*/

		TAuthInfo iAuthInfo;

		/** The pseudorandom data that is chosen by the client.*/

		TAuthData iChallenge;

		/** Calculated by the client with the MD5 algorithm using 

		iChallenge, iId and iPassword.*/

		TAuthData iResponse;

		/** A one byte identifier that is chosen by the client.*/

		TUint8 iId;

		/** Primary and secondary DNS server names since version 2 

		of the API.*/

		TDnsInfoV2 iDnsAddresses;

		TMiscProtocolBuffer iMiscBuffer;

		};

	class TContextConfigGPRS : public TPacketDataConfigBase

	/**

	Context configurations for GPRS packet data support. 

	Contains all the data necessary to configure a context on a GPRS network or 

	UMTS packet network.

	@publishedPartner

	@released

	*/

		{

	public:

		IMPORT_C TContextConfigGPRS();

	public:

		/** The GPRS protocol type. The default value is EpdpTypeIPv4.

		@see TProtocolType */

		TProtocolType iPdpType;

		/** The GPRS Access point name. The default value is an empty string.

		@see TGSNAddress */

		TGSNAddress iAccessPointName;

		/** The GPRS protocol address. The default value is an empty string.

		@see TProtocolAddress */

		TProtocolAddress iPdpAddress;		

		/** The GRPS compression. This is a bit-wise sum of the wanted compression. The 

		default value is 0.

		@see KPdpDataCompression

		@see KPdpHeaderCompression */

		TUint iPdpCompression;

		/** Anonymous access requested. The default value is ENotRequired.

		@see TAnonymousAccess */

		TAnonymousAccess iAnonymousAccessReqd;

		/** Use Edge. The default value is EFalse. True for EGPRS.*/

		TBool iUseEdge; // 

		/** Protocol configuration options for version 2 of the API.

		Supported from v7.0S.*/

		TProtocolConfigOptionV2 iProtocolConfigOption;

		/** Network initiated context indication. */

		TBool iNWIContext;

		};

   	/**

	Identifiers for Packet Flow Context.  See Table 10.5.161/3GPP TS 24.008.

   	*/

   	enum TPacketFlowIdentifier

   		{

   		/**

   		Best Effort

   		*/

   		EBestEffort,

		/**

		Signalling

		*/

		ESignalling,

		/**

		Sms

		*/

   		ESms

   		};

  	class TContextConfigR99_R4 : public TPacketDataConfigBase

	/**

	Enables Release 99 and Release 4 context configuration for version 2 of 

  	the API.

  	Contains all the data necessary to configure a context on a R99/R4 packet 

  	network. 

  	Supported from v7.0S.

	@publishedPartner

	@released

  	*/

  		{

  	public:

  		IMPORT_C TContextConfigR99_R4();

  	public:

  		/** The Rel99/Rel4 protocol type. The default value is EpdpTypeIPv4.*/

  		TProtocolType iPdpType;

  		/** The Rel99/Rel4 access point name. The default is an empty string.*/

  		TGSNAddress iAccessPointName;

  		/** The Rel99/Rel4 protocol address. The default value is an empty string.*/

  		TProtocolAddress iPdpAddress;		

  		/** Use Edge. The default is EFalse. True for EGPRS.*/

   		TBool iUseEdge; 

   		/** Protocol configuration options.*/

		TProtocolConfigOptionV2 iProtocolConfigOption;

		TBool iNWIContext; // Network initiated context indication.

		TPacketFlowIdentifier iPFI; // Packet Flow indicator.

		};

	class TContextConfigCDMA : public TPacketDataConfigBase

	/**

	Enables context configurations for CDMA and CDMA2000 packet data 

	and high speed packet data support. 

	Contains all the data necessary to configure a context on a CDMA packet 

	network.

	@publishedPartner

	@released

	*/

		{

	public:

		IMPORT_C TContextConfigCDMA();

	public:

	/** Identifies the CDMA packet service option range (Low, High, High CDMA2000). 

	The default value is KLowSpeedData.

	@see TServiceOption */

		TUint			iServiceOption; 

	/** The CDMA protocol type, either PPP or CDPD. The default value is EPdpTypePPP.

	@see TProtocolType */

		TProtocolType	iProtocolType;	

		};

	// Configuration-related calls

	IMPORT_C void SetConfig(TRequestStatus& aStatus, const TDesC8& aConfig) const;

	IMPORT_C void GetConfig(TRequestStatus& aStatus, TDes8& aConfig) const;

	IMPORT_C void NotifyConfigChanged(TRequestStatus& aStatus, TDes8& aConfig) const;

	IMPORT_C void Activate(TRequestStatus& aStatus) const;

	IMPORT_C void Deactivate(TRequestStatus& aStatus) const;

	IMPORT_C void Delete(TRequestStatus& aStatus) const;

	IMPORT_C void LoanCommPort(TRequestStatus& aStatus, RCall::TCommPort& aDataPort) const; // Deprecated method.

	IMPORT_C void RecoverCommPort(TRequestStatus& aStatus) const; // Deprecated method.

	IMPORT_C void GetDnsInfo(TRequestStatus& aStatus, TDes8& aDnsInfo) const; 

	enum TContextStatus

		{

	/** Current status is unknown. */

		EStatusUnknown,

	/** Context is not activated. */

		EStatusInactive,

	/** Context is currently being activated. */

		EStatusActivating,

	/** Context is active. */

		EStatusActive,

	/** Context is currently being deactivated. */

		EStatusDeactivating,		

	/** Context is suspended. */

		EStatusSuspended,

	/** Context has been deleted. */

		EStatusDeleted,

	/** Context is currently in data receiving mode.The service transitions 

		to this state when the data transmission starts.This is expected 

		to happen after some time of arrival of SESSION START message from the network.

	    Note : Applicable only to MBMS context */	

		EStatusReceiving

		};

	IMPORT_C TInt GetStatus(TContextStatus& aContextStatus) const;

	IMPORT_C void NotifyStatusChange(TRequestStatus& aStatus,TContextStatus& aContextStatus);

	IMPORT_C TInt GetProfileName(TName& aQoSProfile) const;

	struct TDataVolume 

/** Holds the amount of sent and received data.

The total number of bytes sent is: iOverflowCounterSent*(2^32)+iOverflowCounterSent */

		{

		TUint32 iBytesSent;

	/** Overflow counter for the bytes sent.

	The total number of bytes sent is: iOverflowCounterSent*(2^32)+iOverflowCounterSent */

		TUint32 iOverflowCounterSent;

	/** The number of bytes received.

	The total number of bytes received is: iOverflowCounterReceived*(2^32)+iOverflowCounterReceived */

		TUint32 iBytesReceived;

	/** Overflow counter for the bytes received.

	The total number of bytes received is: iOverflowCounterReceived*(2^32)+iOverflowCounterReceived */

		TUint32 iOverflowCounterReceived;

		};

	struct TNotifyDataTransferredRequest

		{

		TUint iRcvdGranularity;

		TUint iSentGranularity;

		};

    /** 

    Determines which fields in the TConnectionInfoXXX parameter class are valid.

    @see TConnectionInfoV1 

    */

	enum TConnectionInfoFlags

		{

    	/** The HSDPA category field is valid in the connection info class.

    	Modes: WCDMA */

		KHSDPACategory		= 0x00000001,

    	/** The HSUPA category field is valid in the connection info class.

    	Modes: WCDMA */		

		KHSUPACategory		= 0x00000002

        };

  	class TConnectionInfoV1 : public TConnectionInfoBase

	/**

	Connection info class is used to carry miscellaneous information about data connection.

  	Contains all kind of packet data connection related information that is useful for

  	ETel API clients.

  	Supported from v9.5.

	@publishedPartner

	@released

  	*/

  		{

  	public:

  		IMPORT_C TConnectionInfoV1();

  	public:

        /**HSDPA UE category as defined in 3GPP TS 25.306 Table 5.1a: "FDD 

        HS-DSCH physical layer categories". Value "0" means HSDPA is not used,

        value "1" means category 1, value "2" means category 2 etc.*/

        TUint iHSDPACategory;

        /*HSUPA (E-DCH) UE category as defined in 3GPP TS 25.306 Table 5.1g: 

        "FDD E-DCH physical layer categories". Value "0" means HSUPA is not used,

        value "1" means category 1, value "2" means category 2 etc.*/       

        TUint iHSUPACategory;

		};

	IMPORT_C TInt GetDataVolumeTransferred(TDataVolume& aVolume) const; // Deprecated method.

	IMPORT_C void NotifyDataTransferred(TRequestStatus& aStatus, TDataVolume& aVolume, TUint aRcvdGranularity=0x1000,TUint aSentGranularity=0x1000) const; 

	IMPORT_C void GetConnectionSpeed(TRequestStatus& aStatus, TUint& aRate) const; // get the current speed (bits per second) of the connection

	IMPORT_C void NotifyConnectionSpeedChange(TRequestStatus& aStatus, TUint& aRate) const;  // notify client if there's a change in the connection speed

	// N.B. the following 2 methoda are only supported if telephony was built with SYMBIAN_ADAPTIVE_TCP_RECEIVE_WINDOW macro

    IMPORT_C void GetConnectionInfo(TRequestStatus& aStatus, TDes8& aInfo) const; // get connection information

	IMPORT_C void NotifyConnectionInfoChange(TRequestStatus &aStatus, TDes8& aInfo) const; // notify client if connection information changes	

	IMPORT_C TInt GetLastErrorCause(TInt& aError) const;

	IMPORT_C void GetDataVolumeTransferred(TRequestStatus& aStatus, TDataVolume& aVolume) const; // Recommended method variant.

	class TDataChannelV2 : public TPacketBase

	/**

	Contains data channel parameters.

	Contains the information previously returned by	LoanCommPort() 

	(iCsy and iPort), as well as the new information which is generated 

	by context creation, e.g. the context (data channel) identity, 

	for version 2 of the API.  

	It is passed as a packaged parameter to RPacketContext::InitialiseContext().

	@publishedPartner

	@released

	*/

		{

	public:

		IMPORT_C TDataChannelV2();

	public:

		/**CSY name.

		@deprecated Data previously used by LoanDataPort() in version 1 of the API.*/

		TFileName iCsy;		

		/**Port name 

		@deprecated Data previously used by LoanDataPort(). */

		TName iPort;			

		/**Context Identity.

		The Channel name information returned by the lower layers (Nif). */

		TName iChannelId;	

		};

	/** 

	Data channel package since version 2 of the API.

	Supported from v7.0S.

	*/

	typedef TPckg<TDataChannelV2> TDataChannelV2Pckg;	

	IMPORT_C void InitialiseContext(TRequestStatus& aStatus, TDes8& aDataChannelV2Pckg) const; // This method supersedes the LoanCommPort() and RecoverCommPort() methods.

	enum {KIPAddressSize = 16};				   ///< TIPAddress size

	/**

	Array to hold either IPv4 or IPv6 address or Subnet mask since version 2 of the API.

	Supported from v7.0S.

	*/	

	typedef TUint8 TIPAddress[KIPAddressSize]; 

	class TPacketFilterV2 : public TPacketBase

	/**

	Packet filter package since version 2 of the API.

	Contains member data compatible with parameters required for configuring 

	a packet filter on a Rel99/R4 packet network. 

	Inherits from the TPacketBase class to make it future 

	proof (extensible).

	Supported from v7.0S.

	@publishedPartner

	@released

	*/

		{

	public:

		IMPORT_C TPacketFilterV2();

	public:

		/** Packet filter identifier. Value range: 1 - 8.*/

		TInt iId;						

		/** Evaluation Precedence Index. Value range: 255 (lowest) - 0 (highest).*/

		TInt iEvaluationPrecedenceIndex;	

		/** Domain Source address.*/

		TIPAddress iSrcAddr;				

		/** Domain Subnet mask.*/

		TIPAddress iSrcAddrSubnetMask;		

		/** Protocol number (IPv4) or Next Header (IPv6) field of incoming packets. 

		Value range 0 - 255.*/

		TInt iProtocolNumberOrNextHeader;	 

		/** Minimum source port number of incoming packets. Value range 0 - 65535.*/

		TInt iSrcPortMin;					 

		/** Maximum source port number of incoming packets. Value range 0 - 65535.*/

		TInt iSrcPortMax;					 

		/** Lowest destination port number of incoming packets. Value range 0 - 65535.*/