/*

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

#define CMCEINEVENT_H

// INCLUDES

#include <mceevent.h>

// FORWARD DECLARATIONS

class CMceManager;

class CMceSession;

class CMceMsgSIPEvent;

// CLASS DECLARATION

/**

* Class for mobile terminated MCE events.

*

* CMceOutEvent represents incoming request to from terminal to establish event dialog.

*

* After the event has been succesfylly set up, it can be later updated and

* must be finally terminated. Notifications about the event are send using NotifyL

* function. The respond to this in not passed to user, unless there is failure.

*

* If for any reason instance of this class is deleted while in active state,

* event is automatically terminated by MCE server.

*

*  @lib mceclient.lib

*/

class CMceInEvent:public CMceEvent

    {

	public:  // Constructors and destructor

	    /**

	    * Destructor.

	    */

	    IMPORT_C ~CMceInEvent();

	public: // New functions

	    /**

	    * Sends accept respond to an incoming event.

	    * @pre State() == CMceEvent::EIdle

	    * @post State() == CMceEvent::EPending	    

	    */

	    IMPORT_C void AcceptL();

	    /**

	    * Sends reject respond to an incoming event.

	    * @pre State() == CMceEvent::EIdle

	    * @post State() == CMCEvent::ETerminated	    

	    */

	    IMPORT_C void RejectL();

	    /**

	    * Sends respond to an incoming event.

	    * @pre State() == CMceEvent::EIdle

	    * @post State() == CMCEvent::ETerminated ||	    

	    *       State() == CMCEvent::EPending	    

	    * @param aReason, reason phrase

	    * @param aCode, reason code

	    * @param aHeaders, SIP headers to be added into respond. Ownership is

		*		 transferred.

		* @param aContentType, a type of content. Ownership

		*		 is transferred.

	    * @param aContent, content to be added in body. Ownership is 

		*		 transferred.

	    */

	    IMPORT_C void RespondL(

					 const TDesC8& aReason,

	                 TUint32 aCode,

	                 CDesC8Array* aHeaders = 0,

					 HBufC8* aContentType = 0,

					 HBufC8* aContent = 0 ); 

	    /**

	    * Sends notification related to an event.

	    * @pre State() == CMceEvent::EIdle

	    * @post State() == CMCEvent::EPending	    

	    * @param aHeaders, SIP headers to be added. Ownership is

		*		 transferred.

	    * @param aContentType, content type of the body.

		*		 Ownership is transferred.

	    * @param aContent, content to be added in a body. Ownership is 

		*		 transferred.

	    */

		IMPORT_C void NotifyL(

					 CDesC8Array* aHeaders = 0, 

					 HBufC8* aContentType = 0,

					 HBufC8* aContent = 0 ); 

	public: 

	    /**

	    * Two-phased constructor.

	    */

	    static CMceInEvent* NewL( CMceManager& aManager,

	                              TUint32 aProfileId,

	                              CMceMsgSIPEvent& aEventMsg );

		TBool IsInEvent() const;

	private: // Functions from base classes

		    /**

	        * C++ default constructor.

	        * @param aManager, reference to event manager.

	        * @param aProfileId, id of the sip profile used for the event.

	        */

		CMceInEvent( CMceManager& aManager, 

		             TUint32 aProfileId,

		             TUint32 aId,

	                 TUint32 aDialogId,

	                 TUint32 aRefreshInterval );

	private: 

	    /**

	    * second-phase constructor

	    */

	    void ConstructL( HBufC8* aEventHeader, 

	                     HBufC8* aRecipient, 

	                     HBufC8* aOriginator,

	                     TUint32 aDialogType );

	    MCE_UNIT_TEST_DEFS

    };

#endif