/*

* 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          : MSIPRequestRouterObserver.h

* Part of       : SIP Server Core

* Version       : SIP/4.0 

*

*/

/**

 @internalComponent

*/

#ifndef MSIPREQUESTROUTEROBSERVER_H

#define MSIPREQUESTROUTEROBSERVER_H

#include <e32base.h>

class MTransactionOwner;

class CSIPResponse;

class MSIPRequestRouterObserver

	{

	public:

		/**

		* Destructor.

    	*/

    	virtual ~MSIPRequestRouterObserver () { }

		/**

		* An owner for the incoming SIP request was found

		* @param aRequestId the request ID

		* @param aOwner the resolved owner. The ownership is not transferred.

    	*/

		virtual void OwnerFoundL(TUint32 aRequestId,

		                         MTransactionOwner* aOwner) = 0;

		/**

		* An owner was not found.

        * The implementation of this callback should generate 

        * a SIP error response with the provided elements and 

        * send it to network.

		* @param aRequestId a request ID

		* @param aSIPResponse a SIP error response. 

		*        The ownership is transferred.

		*/

		virtual void OwnerNotFoundL(TUint32 aRequestId,

								    CSIPResponse* aSIPResponse) = 0;

		/**

		* Error occurred during resolution.

        * This callback will also be called if one of the callbacks 

        * OwnerFoundL or OwnerNotFoundL leaves using the leave code.

        * @param aRequestId a request ID

		* @param aError error code. 

		*/

		virtual void ErrorOccurred(TUint32 aRequestId, TInt aError) =0;

	};

#endif // MSIPREQUESTROUTEROBSERVER_H