/*
* 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 MMCEINSESSIONOBSERVER_H
#define MMCEINSESSIONOBSERVER_H

//  INCLUDES
#include <e32base.h>

// FORWARD DECLARATIONS
class CMceSession;
class CMceInSession;
class TMceTransactionDataContainer;

// CLASS DECLARATION

/**
*  An interface to be implemented by users of MCE if they wish to receive
*  invitations to session from network.
*
*  This observer is set using CMceManager::SetInSessionObserver function.
*
*  @lib mceclient.lib
*/
class MMceInSessionObserver
	{

	public: // Functions

	    /**
	    * Incoming session invitation. The CMceInSession is given to the
		* application as a callback.
	    * @param aSession, pointer to the incoming session. Ownership is
		*	     transferred.
	    * @param aContainer, if present, holds details of
	    *        transaction causing state change.
	    */
		virtual void IncomingSession(
	                CMceInSession* aSession,
    				TMceTransactionDataContainer* aContainer ) = 0;
    				    				
	    /**
	    * Incoming session update. The new updated CMceInSession is given to the
		* application as a callback.
	    * @param aOrigSession, the original session to be updated. This instance
	    *        cannot be used anymore, all actions done using aUpdatedSession instance.
	    * @param aUpdatedSession, pointer to the new updated session. Ownership is
		*	     transferred.
	    * @param aContainer, if present, holds details of
	    *        update transaction.
	    */
		virtual void IncomingUpdate(
					CMceSession& aOrigSession, 
					CMceInSession* aUpdatedSession,
    				TMceTransactionDataContainer* aContainer ) = 0;

	};

#endif
