/*
* Copyright (c) 2005-2009 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:
* Name        : msipresponsesender.h
* Part of     : SIP Client
* Interface   : SDK API, SIP API
* Version     : 1.0
*
*/




/**
 @internalComponent
*/

#ifndef MSIPRESPONSESENDER_H
#define MSIPRESPONSESENDER_H

// FORWARD DECLARATIONS
class CSIPClientConnection;
class CSIPResponseElements;
class CSIPDialogImplementation;

// CLASS DECLARATION

/**
*  An interface implementing the sending of response within server transaction.
*
*  @lib n/a
*/
class MSIPResponseSender
	{
    public: // Constructors and destructor
		/** 
		* destructor
		*/
		virtual ~MSIPResponseSender() {}

    public: // New functions		
        /**
		* Sends a SIP response using the provided client connection.
        *
		* @param aConnection SIP client connection to use for sending
        * @param aElements Response elements
        * @param aRequestId RequestId
        * @param aAffectsDialogState ETrue if the transaction which is
        *   sending the response, has an effect on the dialog state.
        *   EFalse otherwise. Has only meaning if the transaction is
        *   associated to a dialog.
        * @param aTargetRefresh ETrue if the request to which the response is
        *   sent, is a target refresh request.
        */
        virtual void SendResponseL(CSIPClientConnection& aConnection,      
                                   const CSIPResponseElements& aElements,
								   TUint32 aRequestId,
                                   TBool aAffectsDialogState,
                                   TBool aTargetRefresh) = 0;

		/**
		* Returns the dialog.
		*
        * @return CSIPDialogImplementation* The dialog inside which the response
        *	will be sent, or NULL if there is no dialog involved.
        *	Ownership is not transferred.
		*/
		virtual CSIPDialogImplementation* Dialog() const = 0;
    };

#endif