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:  See class definition below.

    15 *

    16 */

    17 

    18 #ifndef MSIPNETWORKOBSERVER_H

    19 #define MSIPNETWORKOBSERVER_H

    20 

    21 // INCLUDES

    22 #include <e32std.h>

    23 

    24 // CLASS DECLARATION

    25 /**

    26 * @publishedPartner

    27 *

    28 * MSIPNetworkObserver defines an interface for observing network state changes.

    29 */

    30 class MSIPNetworkObserver

    31 	{

    32 	public: // Enumerations

    33 

    34 		/// Network states

    35 		enum TNetworkState

    36 			{

    37 			ENetworkUnknown,

    38 			ENetworkConnected,

    39 			ENetworkInactive,

    40 			ENetworkActive,

    41 			ENetworkSuspended,

    42 			EConnectionLost

    43 			};

    44 

    45 	protected: // Constructors and destructors

    46 

    47 		/// Virtual destructor. Prohibit deletion through this interface.

    48 		virtual ~MSIPNetworkObserver() {};

    49 

    50 	public: // Abstract methods

    51 

    52 		/**

    53 		 * Called by a when the network state has changed.

    54 		 *

    55 		 * @param aState Current network state

    56 		 * @param aError KErrNone if state was changed succesfully, otherwise

    57 		 *				 one of the system-wide error codes.

    58 		 */

    59 		virtual void NetworkStateChanged( 

    60 		    MSIPNetworkObserver::TNetworkState aState,

    61 		    TInt aError ) = 0;

    62 	};

    63 

    64 #endif // MSIPNETWORKOBSERVER_H