/*

* Copyright (c) 2008 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:  Defination of class CMCSInterface

*

*/

#ifndef __MCSMCINTERFACE_H

#define __MCSMCINTERFACE_H

#include <liwcommon.h>

#include <liwserviceifbase.h>

#include <liwbufferextension.h>

class CMCSService;

class TMenuItem;

/**

 * This class provides the MCS SAPI interface to LIW Framework 

*/

class CMCSMCInterface : public CBase, public MLiwInterface

	{

	public:

	    /**

	     * Two-phased constructor.

	     * @return CMCSMCInterface* 

	    */

		static CMCSMCInterface* NewL(const TDesC& aContent);

	    /**

	    * Destructor.

	    */

		virtual ~CMCSMCInterface();

	private:

		/**

	     * Constructor

	    */

		CMCSMCInterface();

		/**

	     * Symbian Constructor

	    */

		void ConstructL(const TDesC& aContent);

	// MLiwInterface member functions

	public:

		/**

	     * Executes the SAPI as per params

	     * @param aCmdName Command name defining which operation is to be performed

	     * @param aInParamList  Input param list

	     * @param aOutParamList Output list

	     * @param aCmdOptions Command option

	     * @param aCallback Callback object pointer

	    */

		virtual void ExecuteCmdL( const TDesC8& aCmdName,

		                       const CLiwGenericParamList& aInParamList,

		                       CLiwGenericParamList& aOutParamList,

		                       TUint aCmdOptions = 0,

		                       MLiwNotifyCallback* aCallback = 0 );

		/**

	     * Closes the interface 

	    */

		virtual void Close();

	/**

     * Static Functions

	 * 

	 * Same functionality required outside the CMCSMCInterface class in case of async

	 * operation. Those set of functions can be given as static.

    */

	public:

		/**

	     * Converts symbian errcode to equivalent SAPI error code

	     * @param aErrorCode Symbian error code

		 *

	     * @return mapped SAPI error code

	    */

 		static TInt32 ErrCodeConversion(TInt aErrorCode);

	private:

		/**

         * Issues GetRunningApplications

         * @param aInParamList Input param list

         * @param aCallback Callback object pointer

         * @return void

        */

        void GetRunningAppsL (const CLiwGenericParamList& aInParamList, 

                MLiwNotifyCallback* aCallback );

		/**

	     * Issues ExecuteAction

	     * @param aInParamList Input param list

         * @param aCallback Callback object pointer

	     * @return void

	    */

		void ExecuteActionL( const CLiwGenericParamList& aInParamList, 

				MLiwNotifyCallback* aCallback );

		/**

	     * Issues Organize

	     * @param aInParamList Input param list

	     * @param aOutParamList Output param list

         * @param aCallback Callback object pointer

	     * @return void

	    */

		void OrganizeL( const CLiwGenericParamList& aInParamList,

		        CLiwGenericParamList& aOutParamList,

		        MLiwNotifyCallback* aCallback );		

		/**

	     * Issues GetGenericParam

	     * @param aInputMap input map

	     * @param aParamName name of parameter

         * @param aOutputList output parameter

	     * @return TBool return true if exist at least one element in list

	    */

		TBool GetParamFromMapL( const CLiwMap* aInputMap,

				const TDesC8& aParamName, RArray<TInt>& aOutputList);

		/**

	     * Issues GetGenericParam

	     * @param aInputMap Input map

	     * @param aParamName name of parameter

         * @param aOutputValue output parameter

	     * @return TBool return true if exist expcected param

	    */

		TBool GetParamFromMapL( const CLiwMap* aInputMap,

				const TDesC8& aParamName, TInt& aOutputValue);

	private:

	  	/**

	     * CMCSService class pointer

	    */		

		CMCSService* iMCSService;

	};

#endif // __MCSMCINTERFACE_H

// End of file