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

// INCLUDES
#include <e32base.h>

// FORWARD DECLARATIONS
class CMceRefer;
class TMceTransactionDataContainer;

// CLASS DECLARATION

/**
*  An interface to be implemented by users of MCE if they wish to use
*  refers.
*
*  This observer is set using CMceManager::SetReferObserver function.
*
*  @lib mceclient.lib
*/
class MMceReferObserver
    {
    public: // New functions
        
		/**
        * The state of the refer has changed.
        * @param aRefer, the refer that has changed.
	    * @param aContainer, if present, holds details of
	    *        transaction causing state change.
        */
        virtual void ReferStateChanged(
        			CMceRefer& aRefer,
    				TMceTransactionDataContainer* aContainer ) = 0;
			
	    /**
	    * The state of the connection used by the refer has changed.
	    * @param aRefer, the refer that has changed.
	    * @param aActive, ETrue if connection active, EFalse if connection inactive.
	    */
	    virtual void ReferConnectionStateChanged(
	                CMceRefer& aRefer,
	                TBool aActive ) = 0;
                
		/**
		* An error has occurred concerning a specific SIP refer.
		* Note, that each error causes the event state to be ETerminated.
		* @param aRefer, The refer raising the error.
		* @param aError, Error code
		*/
		virtual void Failed(CMceRefer& aRefer, TInt aError ) = 0;
    };

#endif