1 /*

     2 * Copyright (c) 2007-2007 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 the License "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:  This Class provides the core functionality for handling mulitiple asynch request

    15 *		     SAPI

    16 *

    17 */

    18 

    19 

    20 

    21 #ifndef __ASYNCHREQUESTMANAGER_H

    22 #define __ASYNCHREQUESTMANAGER_H

    23 

    24 #include "appmanagercommon.h"

    25 

    26 class CLauncherObserver;

    27 class MAppObserver;

    28 

    29 

    30 /**

    31 * This Class provides the core functionality of

    32 * Application Manager SAPI

    33 *

    34 * @since  Series60 v3.2

    35 */

    36 class CAsynchRequestManager : public CBase

    37     {

    38 

    39     public:

    40 

    41     	/**

    42         * Returns the instance of CAsynchRequestManager.

    43         * @since  Series60 v3.2

    44         * @param  void

    45         * @return CAsynchRequestManager* return the instance of CAsynchRequestManager class

    46         */

    47         IMPORT_C static CAsynchRequestManager* NewL();

    48 

    49         /**

    50     	* Destructor.

    51     	*/

    52         virtual ~CAsynchRequestManager();

    53 

    54      

    55 

    56         /**

    57         * Cancel the pending asynchronous request

    58         * @since  Series60 v3.2

    59         * @param  aTransactionID  Unique number to identify the request

    60         * @return TInt System wide error code

    61         */

    62         IMPORT_C TInt Cancel( TInt32 aTransactionID );

    63 

    64 

    65 

    66         /**

    67         * This function delete the callback object from the array

    68         * corresponding to the given transaction id

    69         * @since  Series60 v3.2

    70         * @param  aTransactionID  Unique number to identify the callback

    71         * @return void

    72         */

    73         void RequestComplete( TInt32 aTransactionID );

    74 

    75 

    76 

    77 

    78        /**

    79         * This function add the callback object for support multiple cancle operation

    80         * @param  MAppObserver observer interface pointer provided by user for informing event.

    81         * @return The observer for actually observing the underlying class events

    82         * @since  Series60 v3.2

    83         */

    84         CLauncherObserver* AddObsereverLC( MAppObserver* aObserver, TInt32& aTransactionID, TThreadId& aThreadId );

    85 

    86    	

    87     private:

    88        

    89         /**

    90 		* Contains handles of all asynchronous requests

    91 	  	*/

    92 		RArray<TAsyncRequestInfo> iAsyncObjArray;

    93 

    94 

    95       };

    96 

    97 #endif __ASYNCHREQUESTMANAGER_H