/*
* 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 Framewrok ECom observer
*
*/
#ifndef C_ECOM_OBSERVER_H
#define C_ECOM_OBSERVER_H
#include <e32base.h> // For CActive, link against: euser.lib
#include <e32std.h> // For RTimer, link against: euser.lib
class REComSession;
/**
* Class defining callback interface.
*/
/**
* MHNEcomInstallNotifierCallback is an interface contains function
* executed when ECom plugin have changed. Interface is used by all
* ECom observer implementations.
*
* @since S60 5.0
* @ingroup group_mmextensions
*/
class MHNEcomInstallNotifierCallback
{
public:
/**
* Refreshes list of MultimediaMenu plugins implementations.
*/
virtual void EcomChangedL() = 0;
};
/**
* Class for observing ECom server
*/
/**
* CMMEcomObserver is a class represents ECom plugin. Class is
* derived by all ECom plugin implemetations. Implementation
* contains basic functionality related with ECom mechanism and
* notification handling.
*
* @since S60 5.0
* @ingroup group_mmextensions
*/
NONSHARABLE_CLASS( CMMEcomObserver ) : public CActive
{
public:
/**
* Cancel and destroy.
*/
~CMMEcomObserver();
/**
* Two-phased constructor.
* @param aCallback Pointer to ECom plugin callback.
* @return Instance of the CMMEcomObserver class.
*/
static CMMEcomObserver* NewL( MHNEcomInstallNotifierCallback* aCallback );
/**
* Two-phased constructor.
* @param aCallback Pointer to ECom plugin callback.
* @return Instance of the CMMEcomObserver class.
*/
static CMMEcomObserver* NewLC( MHNEcomInstallNotifierCallback* aCallback );
private:
/**
* Default C++ constructor.
*/
CMMEcomObserver();
/**
* Second-phase constructor.
* @param aCallback Pointer to ECom plugin callback.
*/
void ConstructL( MHNEcomInstallNotifierCallback* aCallback );
private:
/**
* From CActive. Handles completion.
*/
void RunL();
/**
* Cancels active object.
*/
void DoCancel();
/**
* Override to handle leaves from RunL(). Default implementation causes
* the active scheduler to panic.
* @param aError Currently error status.
* @return Error code.
*/
TInt RunError( TInt aError );
private:
/**
* ECom handler
* Own.
*/
REComSession* iSession;
/**
* Callback pointer.
* Not own.
*/
MHNEcomInstallNotifierCallback* iCallback;
};
#endif // C_ECOM_OBSERVER_H