/*
* Copyright (c) 2005 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:
*
*/
#ifndef MMCEEVENTOBSERVER_H
#define MMCEEVENTOBSERVER_H
// INCLUDES
#include <e32base.h>
// FORWARD DECLARATIONS
class CMceEvent;
class TMceTransactionDataContainer;
// CLASS DECLARATION
/**
* An interface to be implemented by users of MCE if they wish to use
* events.
*
* This observer is set using CMceManager::SetEventObserver function.
*
* @lib mceclient.lib
*/
class MMceEventObserver
{
public: // New functions
/**
* The state of the event has changed.
* @param aEvent, the event that has changed.
* @param aContainer, if present, holds details of
* transaction causing state change.
*/
virtual void EventStateChanged(
CMceEvent& aEvent,
TMceTransactionDataContainer* aContainer ) = 0;
/**
* The state of the event has changed.
* @param aEvent, event received notification.
* @param aContainer, if present, holds details of
* transaction causing state change.
*/
virtual void NotifyReceived(
CMceEvent& aEvent,
TMceTransactionDataContainer* aContainer ) = 0;
/**
* The state of the event used by the refer has changed.
* @param aEvent, the event that has changed.
* @param aActive, ETrue if connection active, EFalse if connection inactive.
*/
virtual void EventConnectionStateChanged(
CMceEvent& aEvent,
TBool aActive ) = 0;
/**
* An error has occurred concerning a specific SIP event.
* Note, that each error causes the event state to be ETerminated.
* @param aEvent, The event raising the error.
* @param aError, Error code
*/
virtual void Failed(CMceEvent& aEvent, TInt aError ) = 0;
};
#endif