--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/IMPSengine/engsrv/inc/impsapplauncherproxy.h Thu Dec 17 08:41:52 2009 +0200
@@ -0,0 +1,175 @@
+/*
+* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: Including CLaunchRequest,CImpsAppLauncherProxy,MImpsAppLaunchHandler.
+* Starts a separate process to launch application
+*/
+
+
+
+#ifndef CIMPSAPPLAUNCHERPROXY_H
+#define CIMPSAPPLAUNCHERPROXY_H
+
+// INCLUDES
+#include <e32base.h>
+#include "impsservercommon.h"
+
+
+// FORWARD DECLARATIONS
+class MImpsAppLaunchHandler;
+
+// CLASS DECLARATION
+/**
+* Launch request
+*/
+
+class CLaunchRequest : public CBase
+ {
+ public:
+ static CLaunchRequest* NewL(
+ const TDesC& aCID,
+ const TDesC& aSAP,
+ const TDesC& aUserId );
+
+ ~CLaunchRequest();
+ void Destroy();
+ bool operator==( CLaunchRequest& rhs );
+ const TDesC& ApplicationId();
+ const TDesC& Sap();
+ const TDesC& UserId();
+
+
+ public: //data
+ TDblQueLink iLink; //lint !e1925
+
+ private:
+ CLaunchRequest( );
+ void ConstructL(
+ const TDesC& aCID,
+ const TDesC& aSAP,
+ const TDesC& aUserId );
+ private:
+ HBufC* iCID;
+ HBufC* iSAP;
+ HBufC* iUserId;
+ };
+
+// CLASS DECLARATION
+/**
+* Application launcher proxy
+* Starts a separate process to launch application
+* and manages the launch requests
+*
+* @since 2.6
+*/
+class CImpsAppLauncherProxy : public CActive
+ {
+ public: // Constructors and destructor
+
+ /**
+ * Two-phased constructor.
+ * @param aLaunchObserver the application launch observer
+ * @return CImpsAppLauncherProxy instance
+ */
+ static CImpsAppLauncherProxy* NewL( MImpsAppLaunchHandler* aLaunchObserver );
+
+ /**
+ * Destructor.
+ */
+ virtual ~CImpsAppLauncherProxy();
+
+ public: // New functions
+
+ /**
+ * Initiates the application launch for the given Client ID
+ * @since 2.6
+ * @param aApplicationId the Application ID of the application to be started
+ * @param aSAP the remote SAP server from where the pending IM came
+ * @param aUserId teh user ID who received the IM
+ * @return error Application
+ */
+ TInt LaunchApplicationL( const TDesC& aApplicationId,
+ const TDesC& aSAP,
+ const TDesC& aUserID );
+
+ protected: // New functions
+
+ /**
+ * Starts the process which loads the launcher ECom plugin
+ * @since 2.6
+ * @param aRequest
+ * @return error status
+ */
+ TInt DoStartProcess( CLaunchRequest& aRequest );
+
+ protected: // Functions from base classes
+
+ /**
+ * From CActive
+ */
+ void DoCancel();
+ void RunL();
+ TInt RunError( TInt aError );
+
+ private:
+
+ /**
+ * C++ default constructor.
+ * @param aLaunchObserver the application launch observer
+ */
+ CImpsAppLauncherProxy( MImpsAppLaunchHandler* aLaunchObserver );
+
+ /**
+ * By default Symbian 2nd phase constructor is private.
+ */
+ void ConstructL();
+
+ /**
+ * Queues the request
+ */
+ void QueueRequest( CLaunchRequest& aRequest );
+
+ /**
+ * Process the next request in queue
+ */
+ void ProcessNextRequestL();
+
+ /**
+ * Checks whether the request is already in queue
+ */
+ TBool IsDuplicate( CLaunchRequest& aRequest );
+
+ private: // Data
+ CLaunchRequest* iCurrentRequest; // the request being handled curently
+ MImpsAppLaunchHandler* iLaunchObserver; // callback handler
+ TDblQue<CLaunchRequest> iRequestList; // request queue
+
+ };
+
+
+// CLASS DECLARATION
+/**
+* Application launcher observer
+* Informs the result of the application launch
+*
+* @since 2.6
+*/
+class MImpsAppLaunchHandler
+ {
+ public:
+ virtual void HandleAppLaunch( const TDesC& aApplicationId, TInt aStatus ) = 0;
+ };
+
+#endif // CIMPSAPPLAUNCHERPROXY_H
+
+// End of File