/*
* Copyright (c) 2007 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: Menu Framework extension plugin
*
*/


#ifndef C_MM_EXTENSION_PLUGIN_H_
#define C_MM_EXTENSION_PLUGIN_H_

#include <e32base.h>
#include <ecom/ecom.h>
#include "mmextensionplugindef.h"

class CLiwGenericParamList;

/**
 * CMMExtensionPlugin is a class representing ECom plugin.
 * Class has virtual function responsible for executing
 * command. It can also returns array of all implementations.
 * Class is deriving by all ECom plugin implementations.
 *
 * @since S60 5.0
 * @ingroup group_mmextensions
 */
NONSHARABLE_CLASS( CMMExtensionPlugin ) : public CBase
	{
public:
 	/** 
 	* Instantiates an object of this type.
    * @param aUid ECom plugin's UID.
    * @param aParams The plugin's parameters.
    * @return Instance of the CMMExtensionPlugin class.
    */
 	static CMMExtensionPlugin* NewL( TUid aUid ,  TAny* aParams );

 	/**
 	 * Virtual C++ Destructor.
 	 */
    virtual ~CMMExtensionPlugin();
    
	/** 
	* Request a list of all available implementations which 
	* satisfy this given interface.
    * @param aImplInfoArray ECom plugin implementations array.
    */
	static void ListAllImplementationsL( RImplInfoPtrArray& aImplInfoArray );

    /**
     * Executes provided action.
     * @param aCommand Command which has to be executed on the plugin.
     *                 Request to the Service.
     * @param aEventParamList Pointer to a list of the event parameters. 
     *                        Its ownership is held in extension manager,
     *                        so if one wishes to use it in asynchronous operations
     *                        then he needs to keep a copy of the data.
     * @return Error code.
     */
    virtual TInt ExecuteActionL( 
        const TDesC& aCommand,
        CLiwGenericParamList* aEventParamList ) = 0;

protected:
	/**
	 * Default constructor.
	 */
	inline CMMExtensionPlugin();

private:
	/**
	 * Unique instance identifier key.
	 */
	TUid iDtor_ID_Key;
	};
	
#include "mmextensionplugin.inl"

#endif /* C_MMEXTENSIONPLUGIN_H_ */

// End of file