/*

* Copyright (c) 2002-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:   This file contains the header file of the RSWInstLauncher

*                class.

*

*/

#ifndef SWINSTAPI_H

#define SWINSTAPI_H

// INCLUDES

#include <AknServerApp.h>

#include <SWInstDefs.h>

// FORWARD DECLARATIONS

class RFile;

namespace SwiUI

{

// FORWARD DECLARATIONS

class CErrDetails;

// CLASS DECLARATION

/**

* Client side handle to access SW Installer UI services.

*  

* @lib swinst.lib

* @since 3.0

*/

class RSWInstLauncher : public RAknAppServiceBase

    {

    public:  // Constructors and destructor

        /**

        * Constructor.

        */

        IMPORT_C RSWInstLauncher();

        /**

        * Creates connection to the server. This will launch the installer

        * as server application.

        * @since 3.0

        * @return Error code

        */

        IMPORT_C TInt Connect();

        /**

        * Closes the connection to the server and close the installer server

        * application.

        * @since 3.0

        */

        IMPORT_C void Close();

        /**

        * Start Installation of the package. The call will return when the installation

        * if over.

        * @since 3.0

        * @param aFileName - Path to the installation package

        * @return Error code.

        */

        IMPORT_C TInt Install( const TDesC& aFileName );

        /**

        * Asynchronous version. The aReqStatus will be completed when installation is finished.

        * To cancel the request, use CancelAsyncRequest with ERequestInstall.

        */

        IMPORT_C void Install( TRequestStatus& aReqStatus, const TDesC& aFileName );

        /**

        * Start Installation of the package 

        * @since 3.0

        * @param aFile - Handle to the installation package.

        * @return Error code

        */

        IMPORT_C TInt Install( RFile& aFile );

        /**

        * Asynchronous version. 

        * To cancel the request, use CancelAsyncRequest with ERequestInstall.

        */

        IMPORT_C void Install( TRequestStatus& aReqStatus, RFile& aFile );

        /**

        * Start Installation of the package 

        * @since 3.0

        * @param aFileName - Path to the installation package

        * @param aParams - Installer parameters. Use TInstallReqPckg to package.

        * @return Error code

        */

        IMPORT_C TInt Install( const TDesC& aFileName, const TDesC8& aParams );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestInstallParams.

        */

        IMPORT_C void Install( TRequestStatus& aReqStatus,

                               const TDesC& aFileName,

                               const TDesC8& aParams );

        /**

        * Start Installation of the package 

        * @since 3.0

        * @param aFile - Handle to the installation package.

        * @param aParams - Installer parameters. Use TInstallReqPckg to package.

        * @return Error code

        */

        IMPORT_C TInt Install( RFile& aFile, const TDesC8& aParams );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestInstallParams.

        */

        IMPORT_C void Install( TRequestStatus& aReqStatus,

                               RFile& aFile, 

                               const TDesC8& aParams );

        /**

        * Start silent installation of the package (client must have TrustedUI capabilities)

        * @since future

        * @param aFileName - Path to the installation package

        * @param aOptions - Default options for installation. Use TInstallOptionsPckg to package.

        * @return Error code

        */  

        IMPORT_C TInt SilentInstall( const TDesC& aFileName, const TDesC8& aOptions );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestSilentInstall.

        */

        IMPORT_C void SilentInstall( TRequestStatus& aReqStatus, 

                                     const TDesC& aFileName, 

                                     const TDesC8& aOptions );

        /**

        * Start silent installation of the package (client must have TrustedUI capabilities)

        * @since future

        * @param aFile - Handle to the installation package.

        * @param aOptions - Default options for installation. Use TInstallOptionsPckg to package.

        * @return Error code

        */  

        IMPORT_C TInt SilentInstall( RFile& aFile, const TDesC8& aOptions );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestSilentInstall.

        */

        IMPORT_C void SilentInstall( TRequestStatus& aReqStatus, 

                                     RFile& aFile, 

                                     const TDesC8& aOptions );

        /**

        * Start silent installation of the package (client must have TrustedUI capabilities)

        * @since future

        * @param aFileName - Path to the installation package

        * @param aParams - Installer parameters. Use TInstallReqPckg to package.

        * @param aOptions - Default options for installation. Use TInstallOptionsPckg to package.

        * @return Error code

        */  

        IMPORT_C TInt SilentInstall( const TDesC& aFileName, 

                                     const TDesC8& aParams, 

                                     const TDesC8& aOptions );  

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestSilentInstallParams.

        */

        IMPORT_C void SilentInstall( TRequestStatus& aReqStatus, 

                                     const TDesC& aFileName,

                                     const TDesC8& aParams, 

                                     const TDesC8& aOptions );

        /**

        * Start silent installation of the package (client must have TrustedUI capabilities)

        * @since future

        * @param aFile - Handle to the installation package.

        * @param aParams - Installer parameters. Use TInstallReqPckg to package.

        * @param aOptions - Default options for installation. Use TInstallOptionsPckg to package.

        * @return Error code

        */  

        IMPORT_C TInt SilentInstall( RFile& aFile, 

                                     const TDesC8& aParams, 

                                     const TDesC8& aOptions );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestSilentInstallParams.

        */

        IMPORT_C void SilentInstall( TRequestStatus& aReqStatus, 

                                     RFile& aFile, 

                                     const TDesC8& aParams, 

                                     const TDesC8& aOptions );

        /**

        * Start UnInstallation of the package 

        * @since future

        * @param aUid - uid of the installed package

        * @param aMIME - Data type of the package to be uninstalled.

        * @return Error code

        */

        IMPORT_C TInt Uninstall( const TUid& aUid, const TDesC8& aMIME );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestUninstall.

        */

        IMPORT_C void Uninstall( TRequestStatus& aReqStatus, 

                                 const TUid& aUid,

                                 const TDesC8& aMIME );

        /**

        * Start silent UnInstallation of the package, (client must have TrustedUI capabilities) 

        * @since future

        * @param aUid - uid of the installed package

        * @param aOptions - Default options for uninstallation. Use TUninstallOptionsPckg to package.

        * @param aMIME - Data type of the package to be uninstalled. 

        * @return Error code

        */                                

        IMPORT_C TInt SilentUninstall( const TUid& aUid, 

                                       const TDesC8& aOptions,

                                       const TDesC8& aMIME );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestSilentUninstall.

        */

        IMPORT_C void SilentUninstall( TRequestStatus& aReqStatus, 

                                       const TUid& aUid,

                                       const TDesC8& aOptions,

                                       const TDesC8& aMIME );

        /**

        * Cancel Asynchronous requests

        * @since 3.0

        */

        IMPORT_C TInt CancelAsyncRequest( TInt aReqToCancel );

        IMPORT_C CErrDetails* GetLastErrorL();

        /**

        * Performs a custom uninstallation.

        * @since 3.0

        * @param aOperation - The operation to be performed.

        * @param aParams - Parameters for the operation

        */ 

        IMPORT_C TInt CustomUninstall( TOperation aOperation, 

                                       const TDesC8& aParams,

                                       const TDesC8& aMIME );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestCustomUninstall.

        */

        IMPORT_C void CustomUninstall( TRequestStatus& aReqStatus, 

                                       TOperation aOperation, 

                                       const TDesC8& aParams,

                                       const TDesC8& aMIME );

        /**

        * Performs a silent custom uninstallation.

        * @since 3.0

        * @param aOptions - Default options for uninstallation.

        * @param aOperation - The operation to be performed.

        * @param aParams - Parameters for the operation

        */ 

        IMPORT_C TInt SilentCustomUninstall( TOperation aOperation, 

                                             const TDesC8& aOptions,

                                             const TDesC8& aParams,

                                             const TDesC8& aMIME );

        /**

        * Asynchronous version

        * To cancel the request, use CancelAsyncRequest with ERequestSilentCustomUninstall.

        */

        IMPORT_C void SilentCustomUninstall( TRequestStatus& aReqStatus, 

                                             TOperation aOperation, 

                                             const TDesC8& aOptions,

                                             const TDesC8& aParams,

                                             const TDesC8& aMIME );

    protected:

        /**

        * Panics the client.

        * @since 3.0

        * @param aPanic - Panic ID.

        * @return System wide error code.

        */

        void PanicClient( TInt aPanic ) const;

    private:  // From base classes

        /**

        * From RApaAppServiceBase, Returns the UID of the service that this session 

        * provides an interface for.

        * @since 3.0

        */

        TUid ServiceUid() const;

    protected:// Data

        TBool iConnected;  // ETrue, if the session has been established

    private:  // Data

        TAny* reserved1;

        TAny* reserved2;

    };

/**

* Client side handle to access SW Installer UI services silenty ( no UI ). 

*  

* @lib swinst.lib

* @since 3.0

*/

class RSWInstSilentLauncher : public RSWInstLauncher

    {

    public:  // Constructors and destructor

        /**

        * Constructor.

        */

        IMPORT_C RSWInstSilentLauncher();

        /**

        * Creates connection to the server. This will launch the installer

        * as a server application. However, the application is started in the background

        * so that status pane is not visible and the task cannot be seen in

        * the tasklist.

        * @since 3.0

        * @return Error code

        */

        IMPORT_C TInt Connect();

    private:  // From base classes

        /**

        * From RApaAppServiceBase, Returns the UID of the service that this session 

        * provides an interface for.

        * @since 3.0

        */

        virtual TUid ServiceUid() const;

    private:  // New functions

        /**

        * Constructs the name of the server application.

        * @since 3.0

        */

        void ConstructServerName( TName& aServerName, 

                                  TUid aAppServerUid, 

                                  TUint aServerDifferentiator );

        /**

        * Starts the server application.

        * @since 3.0

        */

        TUint StartServerL( TUid aAppUid );

        /**

        * Launches the server application.

        * @since 3.0

        */

        void LaunchAppL( TUid aAppUid, TUint aServerDifferentiator, TThreadId& aThreadId );        

    private:    // Data

        TAny* reserved;

    };

}

#endif      //  SWINSTAPI_H 

// End of File