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 MMCEINSESSIONOBSERVER_H

    20 #define MMCEINSESSIONOBSERVER_H

    21 

    22 //  INCLUDES

    23 #include <e32base.h>

    24 

    25 // FORWARD DECLARATIONS

    26 class CMceSession;

    27 class CMceInSession;

    28 class TMceTransactionDataContainer;

    29 

    30 // CLASS DECLARATION

    31 

    32 /**

    33 *  An interface to be implemented by users of MCE if they wish to receive

    34 *  invitations to session from network.

    35 *

    36 *  This observer is set using CMceManager::SetInSessionObserver function.

    37 *

    38 *  @lib mceclient.lib

    39 */

    40 class MMceInSessionObserver

    41 	{

    42 

    43 	public: // Functions

    44 

    45 	    /**

    46 	    * Incoming session invitation. The CMceInSession is given to the

    47 		* application as a callback.

    48 	    * @param aSession, pointer to the incoming session. Ownership is

    49 		*	     transferred.

    50 	    * @param aContainer, if present, holds details of

    51 	    *        transaction causing state change.

    52 	    */

    53 		virtual void IncomingSession(

    54 	                CMceInSession* aSession,

    55     				TMceTransactionDataContainer* aContainer ) = 0;

    56     				    				

    57 	    /**

    58 	    * Incoming session update. The new updated CMceInSession is given to the

    59 		* application as a callback.

    60 	    * @param aOrigSession, the original session to be updated. This instance

    61 	    *        cannot be used anymore, all actions done using aUpdatedSession instance.

    62 	    * @param aUpdatedSession, pointer to the new updated session. Ownership is

    63 		*	     transferred.

    64 	    * @param aContainer, if present, holds details of

    65 	    *        update transaction.

    66 	    */

    67 		virtual void IncomingUpdate(

    68 					CMceSession& aOrigSession, 

    69 					CMceInSession* aUpdatedSession,

    70     				TMceTransactionDataContainer* aContainer ) = 0;

    71 

    72 	};

    73 

    74 #endif