1 /*

     2 * Copyright (c) 2005 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 *

    16 */

    17 

    18 

    19 #ifndef MMUSAVASIPADAPTER_H

    20 #define MMUSAVASIPADAPTER_H

    21 

    22 //  INCLUDES

    23 #include <e32base.h>

    24 

    25 // FORWARD DECLARATIONS

    26 class CSIPServerTransaction;

    27 

    28 // CLASS DECLARATION

    29 

    30 /**

    31 *  @publishedAll

    32 *  @released

    33 *

    34 *  An interface to be implemented by users of CSIPConnection.

    35 *  Interface allows to be able to receive requests, responses, connection state

    36 *  notifications and error notifications from sip stack.

    37 *

    38 *  Note: The client must not delete related CSIPConnection object 

    39 *  during the execution of the interface function.

    40 *

    41 *  @lib n/a

    42 */

    43 

    44 class MMusAvaSipAdapter

    45 	{    	

    46     public:

    47         /**

    48         * A SIP request has been received from the network.

    49         * This function is called when the SIP request was received using such

    50         * an IAP, for which the application has not created a CSIPConnection

    51         * object.

    52         * @pre aTransaction != 0

    53         * @param aIapId The IapId from which the SIP request was received.

    54         * @param aTransaction contains local address, remote address of a SIP

    55         *        message, as well as optional SIP message method, headers and

    56         *        body. The ownership is transferred.

    57         */

    58         virtual TInt IncomingRequest(TUint32 aIapId,

    59                                      CSIPServerTransaction* aTransaction) = 0;

    60 

    61         /**

    62         * The received SIP request time-outed and it is invalid i.e. cannot be used

    63         * anymore.

    64         * This will be called if the user fails to create a SIP connection and

    65         * does not send an appropriate SIP response.

    66         * @param aTransaction The time-outed transaction.

    67         */

    68         virtual TInt TimedOut(CSIPServerTransaction& aTransaction) = 0;

    69 	};

    70 

    71 #endif // MMUSAVASIPCONNECTIONADAPTER_H