1 /*

     2 * Copyright (c) 2007-2008 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:    Observer interface used to receive notifications about

    15 *                incoming STUN requests from NAT FW STUN server

    16 *

    17 */

    18 

    19 

    20 

    21 

    22 #ifndef NATFWSTUNSRVOBSERVER_H

    23 #define NATFWSTUNSRVOBSERVER_H

    24 

    25 #include "natfwconnectivityapidefs.h"

    26 

    27 /**

    28  * Observer interface used to receive notifications about

    29  * incoming STUN requests from NAT FW STUN server

    30  *

    31  * @lib stunserver.lib

    32  * @since S60 v3.2

    33  */

    34 class MNATFWStunSrvObserver

    35     {

    36 

    37 public:

    38 

    39     /**

    40      * Called by NATFW STUN Server when incoming STUN request is found.

    41      *

    42      * @since S60 v3.2

    43      * @param aLocalAddr     local address. 

    44      * @param aFromAddr      address the server saw in request.

    45      * @param aPeerAddr      peer remote address.

    46      * @param aPriority      proirity.

    47      * @param aRemoteFavored Candidate pair resulting from this check should 

    48      *                       be used for transmission of media if true.

    49      * @return void

    50      */

    51     virtual void STUNRequestReceivedL( const TInetAddr& aLocalAddr,

    52         const TInetAddr& aFromAddr, const TInetAddr& aPeerAddr,

    53         TUint aPriority, TBool aRemoteFavored ) = 0;

    54         

    55         

    56     /**

    57      * Called by NATFW Stun Server if role conflict is present between agents

    58      * and role change is needed to this agent. 

    59      *

    60      * @since S60 v3.2

    61      * @param aDesiredRole Desired role.    

    62      * @return void

    63      */

    64     virtual void RoleChangeNeeded( TNATFWIceRole aDesiredRole ) = 0;  

    65 

    66     };

    67 

    68 

    69 #endif // NATFWSTUNSRVOBSERVER_H