/*

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

#define MUSENGOUTSESSIONOBSERVER_H

// INCLUDES

#include <badesca.h>

// FORWARD DECLARATIONS

class MMusEngAsyncRetryObserver;

// CLASS DECLARATION

/**

* An interface to be implemented by users of Multimedia Sharing Engine if they 

* wish to receive feedback from outsent INVITE. All the callback functions 

* represent an answer from network to sent INVITE.

*/

class MMusEngOutSessionObserver

    {

    public:

        /**    

        * Indicates that preconditions for sending invitation cannot be met.

        */

        virtual void UnableToSendInvitation() = 0;

	    /**    

        * Indicates that no response received to invitation

        */

        virtual void NoResponseReceivedToInvitation() = 0;

		/**    

   		* Indicates that MT has rejected session. ( e.g. 603 DECLINE ).

		*/

     	virtual void SessionRejected() = 0;

    	/**

    	* The following functions represent a specific reason in answer

    	* to sent INVITE.

    	*/

		virtual void SessionBadRequest() = 0; // 400 

		virtual void SessionUnauthorized() = 0; // 401 

		virtual void SessionPaymentRequired() = 0; // 402

    	virtual void SessionRecipientNotFound() = 0; // 404 

		virtual void SessionProxyAuthenticationRequired() = 0; // 407

		virtual void SessionRequestTimeOut() = 0; // 408

		virtual void SessionUnsupportedMediaType() = 0; // 415

		virtual void SessionBusyHere() = 0; // 486

		virtual void SessionRequestCancelled() = 0; // 487    	

  	    virtual void SessionTemporarilyNotAvailable() = 0; // 480

  	    /**

  	    * Indicates possibility to retry session. Recipient proposal is given

  	    * but implementation can query user for new recipient address.

  	    * Retry address should be filled to aRetryAddress on return.

  	    * @return ETrue if retry should be made

  	    */

  	    virtual TBool RetrySessionSync( const TDesC& aRecipientProposal,

                                        TDes& aRetryAddress ) = 0;

  	    /**

  	    * Indicates that retry with given address is proceeding.

  	    */

  	    virtual void RetryProceeding() = 0;

  	    /**

  	    * Indicates that there's multiple suitable recipient addresses.

  	    * Client can choose what to use.

  	    * @param aAddressArray, list of suitable recipient addresses

  	    * @param aRecipientAddress, on return should contain recipient

  	    *    address to be used

  	    * @return ETrue if recipient was selected, otherwise EFalse

  	    */

  	    virtual TBool SelectRecipientL( CDesCArray& aAddressArray, 

                                        TDes& aRecipientAddress ) = 0;

    };

#endif