diff -r a36b1e19a461 -r 989d2f495d90 serviceproviders/sapi_applicationmanager/inc/appmanagerinterface.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/serviceproviders/sapi_applicationmanager/inc/appmanagerinterface.h Fri Jul 03 15:51:24 2009 +0100 @@ -0,0 +1,158 @@ +/* +* Copyright (c) 2007-2007 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "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: This Class provides the interface for +* calling the functionality to Application Manager SAPI. +* +*/ + + + +#ifndef __CAPPMANAGERINTERFACE_H +#define __CAPPMANAGERINTERFACE_H + + + +class CAppManagerService; +class CAppManagerServiceObserver; + +#include +// CLASS DECLARATION + + + +/** +* Interface class for Application Manager SAPI. +* +* @code +* MLiwInterface* Interface = CAppManagerInterface::NewL(); +* Interface->ExecuteCmdL(KGetList,input,output,KLiwOptSyncronous); +* @endcode +* +* +* @since Series60 v3.2 +*/ + +class CAppManagerInterface : public CBase, public MLiwInterface + { + public: + /** + * Two-phased constructor + * @since Series60 v3.2 + * @param void + * @return CAppManagerInterface* Returns the instance of + * CAppManagerInterface. + */ + static CAppManagerInterface* NewL(); + + /** + * Destructor. + */ + virtual ~CAppManagerInterface(); + + /** + * This function handles the request of consumer + * @since Series60 v3.2 + * @param aCmdName Command name of SAPI + * @param aInParamList Contains argument on which operation has to + be performed + * @param aOutParamList Result of given command will be + * stored in the output paramater list + * @param aCmdOptions Set option for asyncronous request or + * for canceling the asyncronous request + * @param aCallback Contains the callback for Asynchronous request + */ + + virtual void ExecuteCmdL(const TDesC8& aCmdName, + const CLiwGenericParamList& aInParamList, + CLiwGenericParamList& aOutParamList, + TUint aCmdOptions = 0, + MLiwNotifyCallback* aCallback = 0); + + + /** + * This function will release all the internal resources + * @since Series60 v3.2 + * @param void + * @return void + */ + virtual void Close() {delete this;} + + /** + * This function will convert Symbian error codes to + * SAPI specific error codes + * @since Series60 v3.2 + * @param aSymbianErr Symbian error code to be converted to SAPI specific + * error code + * @return An integer error code + */ + static TInt SapiError( TInt aSymbianErr ); + + private: + + /** + * constructor + * @since Series60 v3.2 + * @param void + * @return void + */ + CAppManagerInterface(); + + /** + * Two-phased constructor + * @since Series60 v3.2 + * @param void + * @return void + */ + void ConstructL(); + /** + * This function will send the request to SAPI core class + * @since Series60 v3.2 + * @param void + * @return void + */ + void GetListL( const CLiwGenericParamList& aInParamList , + CLiwGenericParamList& aOutParamList ); + + /** + * This function will send the request to SAPI core class + * @since Series60 v3.2 + * @param void + * @return void + */ + void LaunchAppL( const CLiwGenericParamList& aInParamList , + CLiwGenericParamList& aOutParamList , + MLiwNotifyCallback* aCallBack = NULL, + TInt32 aTransactionID = 0 ); + /** + * This function will send the request to SAPI core class + * @since Series60 v3.2 + * @param void + * @return void + */ + void LaunchDocL( const CLiwGenericParamList& aInParamList, + CLiwGenericParamList& aOutParamList, + MLiwNotifyCallback* aCallBack = NULL, + TInt32 aTransactionID = 0 ); + + + private: + /** + * Stores the instance of SAPI Core Class + */ + CAppManagerService *iCoreClass; + + +}; + +#endif __CAPPMANAGERINTERFACE_H \ No newline at end of file