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

// This file contains all the interfaces classes that can be implemented by

// the Licensee LTSY relating to PacketServices related features.

//

/**

 @file

 @internalAll 

*/

#ifndef MLTSYDISPATCHPACKETSERVICESINTERFACE_H_

#define MLTSYDISPATCHPACKETSERVICESINTERFACE_H_

#include <ctsy/ltsy/mltsydispatchinterface.h>

#include <etelpckt.h>

#include <etelqos.h>

class MLtsyDispatchPacketServicesPacketAttach : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesPacketAttachApiId = KDispatchPacketServicesFuncUnitId + 1;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketAttach

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesPacketAttachComp()

	 *

	 * Implementation of this interface should issue an attach request to the LTSY.

	 * 	

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandlePacketAttachReqL() = 0;

	}; // class MLtsyDispatchPacketServicesPacketAttach

class MLtsyDispatchPacketServicesGetPacketAttachMode : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesGetPacketAttachModeApiId = KDispatchPacketServicesFuncUnitId + 2;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketGetAttachMode

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesGetPacketAttachModeComp()

	 *

	 * Implementation of this interface will return the attach mode. However if the call is

	 * being made during a packet service open process it will skip the get attach mode call.

	 * 		 	

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleGetPacketAttachModeReqL() = 0;

	}; // class MLtsyDispatchPacketServicesGetPacketAttachMode

class MLtsyDispatchPacketServicesGetPacketNetworkRegistrationStatus : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesGetPacketNetworkRegistrationStatusApiId = KDispatchPacketServicesFuncUnitId + 3;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketGetNtwkRegStatus

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesGetPacketNetworkRegistrationStatusComp()

	 *

	 * Implementation of this interface should retrieve the packet network registration status 

	 * from the baseband.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleGetPacketNetworkRegistrationStatusReqL() = 0;

	}; // class MLtsyDispatchPacketServicesGetPacketNetworkRegistrationStatus

class MLtsyDispatchPacketServicesPacketDetach : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesPacketDetachApiId = KDispatchPacketServicesFuncUnitId + 4;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketDetach

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesPacketDetachComp()

	 * 	 

	 * Implementation of this interface should issue a detach request to the LTSY.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandlePacketDetachReqL() = 0;

	}; // class MLtsyDispatchPacketServicesPacketDetach

class MLtsyDispatchPacketServicesSetPdpContextConfig : public MLtsyDispatchInterface

	{	

public:

	static const TInt KLtsyDispatchPacketServicesSetPdpContextConfigApiId = KDispatchPacketServicesFuncUnitId + 5;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketContextSetConfig

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetPdpContextConfigComp()

	 * Implementation of this interface should pass LTSY the parameters it needs to set the 

	 * context configuration 

	 *

	 * @param aContextId the context name

	 * @param aAccessPointName the access name which identifies the GGSN to be used

 	 * @param aPdpType the protocol type

 	 * @param aPdpAddress the PDP address for this context

 	 * @param aPcoBuffer the pco buffer

 	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleSetPdpContextConfigReqL(const TDesC& aContextId,

			const TDesC8& aAccessPointName,

			const RPacketContext::TProtocolType aPdpType,

			const TDesC8& aPdpAddress,

			const TDesC8& aPcoBuffer) = 0;

	}; // class MLtsyDispatchPacketServicesSetPdpContextConfig

class MLtsyDispatchPacketServicesModifyActivePdpContext : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesModifyActivePdpContextApiId = KDispatchPacketServicesFuncUnitId + 6;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketContextModifyActiveContext

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesModifyActivePdpContextComp()

	 * Implementation of this interface should signal to the Licensee TSY that it can action the modification

	 * of an existing context, the changes being indicated via appropriate RPacketContext::SetConfig and 

	 * RPacketContext::SetProfileParameters calls

	 *

	 * @param aContextName the context name.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleModifyActivePdpContextReqL(const TDesC& aContextName) = 0;

	}; // class MLtsyDispatchPacketServicesModifyActivePdpContext

class MLtsyDispatchPacketServicesInitialisePdpContext : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesInitialisePdpContextApiId = KDispatchPacketServicesFuncUnitId + 7;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketContextInitialiseContext

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesInitialisePdpContextComp()

	 * Implementation of this interface should initialise either primary or secondary contexts

	 *

	 *

     * @param aPrimaryContextName Primary context name in the form of a character string, 

	 * the maximum length of the descriptor should not exceed KMaxInfoName.

     * @param aSecondaryContextName Optional secondary context name in the form of a character

     * string, the maximum length of the descriptor should not exceed KMaxInfoName.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleInitialisePdpContextReqL(const TDesC& aPrimaryContextName, const TDesC& aSecondaryContextName) = 0;

	}; // class MLtsyDispatchPacketServicesInitialisePdpContext

class MLtsyDispatchPacketServicesDeletePdpContext : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesDeletePdpContextApiId = KDispatchPacketServicesFuncUnitId + 8;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketContextDelete

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesDeletePdpContextComp()

	 *

	 * Implementation of this interface should delete the context given.      

	 * 

	 * @param aContextName The name of the context to delete, 

	 * the maximum length of the descriptor should not exceed KMaxInfoName.

	 * 

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleDeletePdpContextReqL(const TDesC& aContextName) = 0;

	}; // class MLtsyDispatchPacketServicesDeletePdpContext

class MLtsyDispatchPacketServicesSetPacketAttachMode : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesSetPacketAttachModeApiId = KDispatchPacketServicesFuncUnitId + 9;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketSetAttachMode

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetPacketAttachModeComp()

	 *

	 * Implementation of this interface should set the packet service attach mode.

	 * @param aAttachMode the attach mode due to be set.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleSetPacketAttachModeReqL(RPacketService::TAttachMode aAttachMode) = 0;

	}; // class MLtsyDispatchPacketServicesSetPacketAttachMode

class MLtsyDispatchPacketServicesNotifyPacketStatusChange : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesNotifyPacketStatusChangeApiId = KDispatchPacketServicesFuncUnitId + 10;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketNotifyStatusChange

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesNotifyPacketStatusChangeComp()

	 *

	 * Implementation of this interface should notify when the status of the packet service was changed.

	 * 

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleNotifyPacketStatusChangeReqL() = 0;

	}; // class MLtsyDispatchPacketServicesNotifyPacketStatusChange

class MLtsyDispatchPacketServicesSetDefaultPdpContextGprsParams : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesSetDefaultPdpContextGprsParamsApiId = KDispatchPacketServicesFuncUnitId + 11;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketSetDefaultContextParams

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetDefaultPdpContextParamsComp()

	 *

	 * Implementation of this interface should set default configuration for Packet Context using GPRS params.

	 *

	 * @param aContextConfigGprs GPRS configuration input parameters.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleSetDefaultPdpContextGprsParamsReqL(const RPacketContext::TContextConfigGPRS& aContextConfigGprs) = 0;

	}; // class MLtsyDispatchPacketServicesSetDefaultPdpContextGprsParams

class MLtsyDispatchPacketServicesSetDefaultPdpContextR99R4Params : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesSetDefaultPdpContextR99R4ParamsApiId = KDispatchPacketServicesFuncUnitId + 12;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketSetDefaultContextParams

	 * request from the CTSY.

	 * 

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetDefaultPdpContextParamsComp()

	 * 

	 * Implementation of this interface should set default configuration for Packet Context using R99/R4 params.

	 *

	 * @param aContextConfigR99R4 R99/R4 configuration input parameters.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleSetDefaultPdpContextR99R4ParamsReqL(const RPacketContext::TContextConfigR99_R4& aContextConfigR99R4) = 0;

	}; // class MLtsyDispatchPacketServicesSetDefaultPdpContextR99R4Params

class MLtsyDispatchPacketServicesActivatePdpContext : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesActivatePdpContextApiId = KDispatchPacketServicesFuncUnitId + 13;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketContextActivate

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesActivatePdpContextComp()

	 *

	 * Implementation of this interface should activate the context given.

	 * 

	 * @param aContextName The context name, the maximum length of the descriptor 

	 * should not exceed KMaxInfoName.	 

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleActivatePdpContextReqL(const TDesC& aContextName) = 0;

	}; // class MLtsyDispatchPacketServicesActivatePdpContext

class MLtsyDispatchPacketServicesSetPdpContextQosGprs : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesSetPdpContextQosGprsApiId = KDispatchPacketServicesFuncUnitId + 14;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketQoSSetProfileParams

	 * request from the CTSY.

	 * 

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetPdpContextQosComp()

	 * 

	 * Implementation of this interface should set GPRS QoS parametes for the given context.

	 *

	 * @param aContextName The name of the context, the maximum length of the 

     * descriptor should not exceed KMaxInfoName.

	 * @param aQoSConfig The QoS configuration parameters.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleSetPdpContextQosGprsReqL(const TDesC& aContextName, const RPacketQoS::TQoSGPRSRequested& aQoSConfig) = 0;

	}; // class MLtsyDispatchPacketServicesSetPdpContextQosGprs

class MLtsyDispatchPacketServicesSetPdpContextQosR99R4 : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesSetPdpContextQosR99R4ApiId = KDispatchPacketServicesFuncUnitId + 15;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketQoSSetProfileParams

	 * request from the CTSY.

	 * 

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetPdpContextQosComp()

	 * 

	 * Implementation of this interface should set R99R4 QoS parametes for the given context.

	 * 

	 *

	 * @param aContextName the name of the context.

	 * @param aQoSConfig the QoS configuration parameters.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleSetPdpContextQosR99R4ReqL(const TDesC& aContextName, const RPacketQoS::TQoSR99_R4Requested& aQoSConfig) = 0;

	}; // class MLtsyDispatchPacketServicesSetPdpContextQosR99R4

class MLtsyDispatchPacketServicesSetPdpContextQosR5 : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesSetPdpContextQosR5ApiId = KDispatchPacketServicesFuncUnitId + 16;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketQoSSetProfileParams

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetPdpContextQosComp()

	 *

	 * Implementation of this interface should set R5 QoS parametes for the given context.

	 *

	 *

	 * @param aContextName The name of the context, the maximum length of the 

	 * descriptor should not exceed KMaxInfoName.

	 * @param aQoSConfig The QoS configuration parameters.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleSetPdpContextQosR5ReqL(const TDesC& aContextName, const RPacketQoS::TQoSR5Requested& aQoSConfig) = 0;

	}; // class MLtsyDispatchPacketServicesSetPdpContextQosR5

class MLtsyDispatchPacketServicesRejectNetworkInitiatedContextActivationRequest : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesRejectNetworkInitiatedContextActivationRequestApiId = KDispatchPacketServicesFuncUnitId + 17;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketRejectActivationRequest

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesRejectNetworkInitiatedContextActivationRequestComp()

	 *

	 * Implementation of this interface should reject the network initiated context activation request.

	 * 

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleRejectNetworkInitiatedContextActivationRequestReqL() = 0;

	}; // class MLtsyDispatchPacketServicesRejectNetworkInitiatedContextActivationRequest

class MLtsyDispatchPacketServicesDeactivatePdpContext : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesDeactivatePdpContextApiId = KDispatchPacketServicesFuncUnitId + 18;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketContextDeactivate

	 * request from the CTSY.

	 *

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesDeactivatePdpContextComp()

	 * Implementation of this interface should deactivate the context indicated by the context name.

	 *

	 *

	 * @param aContextName The context name that is to be deactivated, 

	 * the maximum length of the descriptor should not exceed KMaxInfoName.

	 *

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.

	 */

	virtual TInt HandleDeactivatePdpContextReqL(const TDesC& aContextName) = 0;

	}; // class MLtsyDispatchPacketServicesDeactivatePdpContext

class MLtsyDispatchPacketServicesAddPacketFilter : public MLtsyDispatchInterface

	{

public:

	static const TInt KLtsyDispatchPacketServicesAddPacketFilterApiId = KDispatchPacketServicesFuncUnitId + 19;

	/**

	 * The CTSY Dispatcher shall invoke this function on receiving the EPacketContextAddPacketFilter

	 * request from the CTSY.

	 * Implementation of this interface should add a packet filter to the packet service.

	 * 

	 * It is a request call that is completed by invoking

	 * CCtsyDispatcherCallback::CallbackPacketServicesSetPdpContextConfigComp()	 

	 * 

	 * @param aContextName The name of the context, the maximum length of the 

	 * descriptor should not exceed KMaxInfoName.

	 * @param aContextFilter An array contains up to eight filters to be used

	 * for configuring the secondary context.

	 * 

	 * @return KErrNone on success, otherwise another error code indicating the

	 * failure.