/*

* Copyright (c) 2006 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:  CCP emergency call class

*

*/

#ifndef MCCPEMERGENCYCALL_H

#define MCCPEMERGENCYCALL_H

//  INCLUDES

#include <e32base.h>

#include <e32cmn.h> // TDesC

/**

* Emergency call class

* @since S60 3.2

*/

class MCCPEmergencyCall

protected:

    /** 

    * Protected destructor. Object cannot be deleted from plug-in client (CCE).

    * @since S60 3.2

    */

    virtual inline ~MCCPEmergencyCall() {};

public:

    * @param aRecipient Emergency call address suggested to be used.

    * Can be given also in CConvergedCallProvider::NewEmergencyCallL.

    * Plug-in will use given address and/or its own known one. 

    * Preferred address usage order:

    * 1) Plug-in own emergency address

    * 2) Address given in Dial

    * 3) Address given in CConvergedCallProvider::NewEmergencyCallL.

    * @return KErrNone if request was started succesfully. 

    * @return KErrNotReady If call is not in idle state.

    * @return KErrNotSupported Emergency call is not supported.

    * Called by CCE instead of HangUp when Dial has been called and state change to 

    * MCCPCallObserver::ECCPStateConnecting has not been received. 

    * Cancels the last ongoing request. Used for Dial only. Not supported for other actions.

    * @param None.

    * @return KErrNone if request was started succesfully. 

    * @since S60 3.2

    * @pre MCCPEmergencyCall::Dial has been called and call state is MCCPCallObserver::ECCPIdle 

    */

    * @param none

    * @return KErrNone If request was started succesfully.

    * @return KErrAlreadyExists If call is already in idle state.

    * @param none

    * @return KErrNone If request was started succesfully.

    * @return KErrNotReady If call is not in ringing or queued state.

#endif // MCCPEMERGENCYCALL_H