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          : SipRequestHandlerObserver.h

    16 * Part of       : SIP Request Handler

    17 * Version       : SIP/4.0 

    18 *

    19 */

    20 

    21 

    22 

    23 

    24 /**

    25  @internalComponent

    26 */

    27 

    28 #ifndef MSIPREQUESTHANDLEROBSERVER_H

    29 #define MSIPREQUESTHANDLEROBSERVER_H

    30 

    31 #include "SipRequestHandlerBase.h"

    32 class CSIPResponse;

    33 

    34 

    35 class MSIPRequestHandlerObserver

    36 	{

    37 	public:

    38 

    39 		/**

    40 		* Destructor.

    41     	*/

    42     	virtual ~MSIPRequestHandlerObserver () { }

    43     

    44 		/**

    45 		* A client UID was resolved for the SIP request

    46 		* @param aRequestId the request ID

    47 		* @param aUid a client UID to which the SIP request must be routed

    48     	*/

    49 		virtual void ClientFoundL(TUint32 aRequestId, TUid aUid) = 0;

    50 

    51 		/**

    52 		* A client UID was not found.

    53         * The implementation of this callback should generate 

    54         * a SIP error response with the provided elements and 

    55         * send it to network.

    56 		* @param aRequestId a request ID

    57 		* @param aSIPResponse a SIP error response. 

    58 		*        The ownership is transferred.

    59 		*/

    60 		virtual void ClientNotFoundL(TUint32 aRequestId,

    61 								     CSIPResponse* aSIPResponse) = 0;

    62 

    63 		/**

    64 		* Error occurred during resolution of the client's channel UID.

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

    66         * ClientFoundL or ClientNotFoundL leaves using the leave code.

    67         * @param aRequestId a request ID

    68 		* @param aError error code. 

    69 		*/

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

    71 	};

    72 

    73 #endif // MSIPREQUESTHANDLEROBSERVER_H