1 /*

     2 * Copyright (c) 2004 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 to receive NWSessionSlot change notifications.

    15 *

    16 */

    17 

    18 #ifndef __MPENGNWSESSIONSLOTOBSERVER2_H

    19 #define __MPENGNWSESSIONSLOTOBSERVER2_H

    20 

    21 //  INCLUDES

    22 #include <E32Std.h>

    23 

    24 

    25 // FORWARD DECLARATIONS

    26 class CPEngNWSessionSlotNotifier2;

    27 class CPEngNWSessionSlotEvent2;

    28 

    29 

    30 // CLASS DECLARATION

    31 

    32 

    33 /**

    34  * Observer interface to get NWSessionSlot change notifications.

    35  * Observer is registered to CPEngNWSessionSlotNotifier2.

    36  *

    37  * @since 3.0

    38  */

    39 class MPEngNWSessionSlotObserver2

    40     {

    41     public: //Observing methods

    42 

    43 

    44         /**

    45          * NWSessionSlot change handler.

    46          *

    47          * Called by CPEngNWSessionSlotNotifier2 to report NWSessionSlot

    48          * changed events. If this method leaves, error code is

    49          * reported back to HandleNWSessionSlotError().

    50          *

    51          * @since 3.0

    52          * @param aNotifier The notifier source where notification

    53          *        is coming from. No ownership transferred.

    54          * @param aEvent The event container.  No ownership transferred.

    55          */

    56         virtual void HandleNWSessionSlotChangeL(

    57             CPEngNWSessionSlotNotifier2& aNotifier,

    58             CPEngNWSessionSlotEvent2& aEvent ) = 0;

    59 

    60 

    61         /**

    62          * Notification failure handler.

    63          *

    64          * @since 3.0

    65          * @param aError The error resulting from Presence Engine internal

    66          *        change event handling (e.g. out of memory) or

    67          *        leave error from HandleNWSessionSlotChangeL().

    68          * @param aNotifier The notifier of which event handling failed.

    69          *        No ownership transferred.

    70          */

    71         virtual void HandleNWSessionSlotError(

    72             TInt aError,

    73             CPEngNWSessionSlotNotifier2& aNotifier ) = 0;

    74 

    75 

    76     private: //Extensions

    77 

    78         /**

    79          * Reserved virtual table slots for future use.

    80          * Do not implement this.

    81          *

    82          * @since 3.0

    83          */

    84         virtual TInt NWSessionSlotObserverReserved() {

    85             return KErrNotSupported;

    86             }

    87 

    88 

    89 

    90     protected:  //Destructor

    91         /**

    92          * Protected destructor.

    93          * Observers can't be destroyed via this interface.

    94          */

    95         virtual ~MPEngNWSessionSlotObserver2() { }

    96 

    97     };

    98 

    99 

   100 #endif //__MPENGNWSESSIONSLOTOBSERVER2_H

   101 

   102 

   103 //End of file

   104 

   105