/*
* 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