1 /*

     2 * Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:

    15 * Name          : MSIPRequestRouterObserver.h

    16 * Part of       : SIP Server Core

    17 * Version       : SIP/4.0 

    18 *

    19 */

    20 

    21 

    22 

    23 

    24 /**

    25  @internalComponent

    26 */

    27 #ifndef MSIPREQUESTROUTEROBSERVER_H

    28 #define MSIPREQUESTROUTEROBSERVER_H

    29 

    30 #include <e32base.h>

    31 class MTransactionOwner;

    32 class CSIPResponse;

    33 

    34 

    35 class MSIPRequestRouterObserver

    36 	{

    37 	public:

    38 

    39 		/**

    40 		* Destructor.

    41     	*/

    42     	virtual ~MSIPRequestRouterObserver () { }

    43     

    44 		/**

    45 		* An owner for the incoming SIP request was found

    46 		* @param aRequestId the request ID

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

    48     	*/

    49 		virtual void OwnerFoundL(TUint32 aRequestId,

    50 		                         MTransactionOwner* aOwner) = 0;

    51 

    52 		/**

    53 		* An owner was not found.

    54         * The implementation of this callback should generate 

    55         * a SIP error response with the provided elements and 

    56         * send it to network.

    57 		* @param aRequestId a request ID

    58 		* @param aSIPResponse a SIP error response. 

    59 		*        The ownership is transferred.

    60 		*/

    61 		virtual void OwnerNotFoundL(TUint32 aRequestId,

    62 								    CSIPResponse* aSIPResponse) = 0;

    63 

    64 		/**

    65 		* Error occurred during resolution.

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

    67         * OwnerFoundL or OwnerNotFoundL leaves using the leave code.

    68         * @param aRequestId a request ID

    69 		* @param aError error code. 

    70 		*/

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

    72 	};

    73 

    74 #endif // MSIPREQUESTROUTEROBSERVER_H