1 /*

     2 * Copyright (c) 2007-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          : sipalrobserver.h

    16 * Part of       : SIP / SIP Profile Agent / SIP ALR Monitor

    17 * Version       : SIP/6.0 

    18 *

    19 */

    20 

    21 

    22 

    23 #ifndef MSIPALROBSERVER_H

    24 #define MSIPALROBSERVER_H

    25 

    26 // INCLUDES

    27 #include <e32std.h>

    28 

    29 // CONSTANTS

    30 const TUint32 KNoIap = 0;

    31 

    32 // CLASS DECLARATION

    33 /**

    34 * Callback to receive notifications about IAP availabilities.

    35 */

    36 class MSipAlrObserver

    37 	{

    38 	public:

    39 

    40         /** ALR events */

    41         enum TEvent

    42             {

    43              /** 

    44             * A new IAP became available.

    45             * When receiving this event the client must call 

    46             * CSipAlrMonitor::AllowMigration or 

    47             * CSipAlrMonitor::DisallowMigration.

    48             */           

    49             EIapAvailable = 0,

    50 

    51             /** 

    52             * A new IAP that became available is now active 

    53             * and the client can start migrating to it.

    54             */

    55             EIapActive = 1,

    56             

    57             /**

    58             * No new IAP available in the used SNAP.

    59             */

    60             ENoNewIapAvailable = 2 ,

    61             

    62 			/**

    63             * Refreshing IAPs failed

    64             */

    65             ERefreshError = 3,

    66             

    67 			/**

    68             * The user has rejected offerred IAP

    69             */

    70             EOfferedIapRejected = 4

    71             };

    72                                    

    73         /**

    74         * ALR related event occurred.

    75         * @param aEvent the event that occurred

    76         * @param aSnapId the SNAP related to the event

    77         * @param aIapId the IAP related to the event

    78         */

    79         virtual void AlrEvent( TEvent aEvent,

    80                                TUint32 aSnapId,

    81                                TUint32 aIapId ) = 0;

    82 

    83 	};

    84 

    85 #endif // MSIPALROBSERVER_H