/*

* 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 CSWInstInstallRequest 

*                class 

*

*                This class implements functionality for install request.

*

*/

#ifndef SWINSTINSTALLREQUEST_H

#define SWINSTINSTALLREQUEST_H

//  INCLUDES

#include <e32base.h>

#include <SWInstDefs.h>

#include "SWInstRequestObject.h"

// FORWARD DECLARATIONS

namespace ContentAccess { class CContent; }

namespace SwiUI

{

// FORWARD DECLARATIONS

class CSWInstUIPluginAPI;

// CLASS DECLARATION

/**

* This class implements functionality for install request.

*

* @since 3.0

*/

class CSWInstInstallRequest : public CSWInstRequestObject

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @param aMessage - Message object having this request.

        */

        static CSWInstInstallRequest* NewL( const RMessage2& aMessage );

        /**

        * Two-phased constructor.

        * @param aMessage - Message object having this request.

        */

        static CSWInstInstallRequest* NewL( TInt aObjectId );

        /**

        * Destructor.

        */

        virtual ~CSWInstInstallRequest();

    public: // New functions

        /**

        * Perform installation

        * @since 3.0

        * @param aFile - Handle to the installation package.

        * @param aParams - install parameters.

        */

        void Install( RFile& aFile, const TInstallReq& aParams );

        /**

        * Perform installation

        * @since 3.0

        * @param aFileName - Path to the installation package.

        * @param aParams - install parameters.

        */

        void Install( const TDesC& aFileName, const TInstallReq& aParams );

        /**

        * Perform silent installation

        * @since 3.0

        * @param aFile - Handle to the installation package.

        * @param aParams - install parameters.

        * @param aOptions - Options for installation

        */

        void SilentInstall( RFile& aFile, 

                             const TInstallReq& aParams, 

                             const TInstallOptions& aOptions );  

        /**

        * Perform silent installation

        * @since 3.0

        * @param aFileName - Path to the installation package.

        * @param aParams - install parameters.

        * @param aOptions - Options for installation

        */

        void SilentInstall( const TDesC& aFileName, 

                             const TInstallReq& aParams, 

                             const TInstallOptions& aOptions );          

    protected: // Functions from base classes

        /**

        * From CSWInstRequestObject, Cancels the current request.

        * @since 3.0

        */

        void CancelRequest();

        /**

        * From CSWInstRequestObject, Gets called when the request is completed.

        * @since 3.0

        */

        void RequestCompleteL( TInt aResult );

    private:  // New functions

        /**

        * C++ default constructor.

        * @param aMessage - Message object having this request.

        */

        CSWInstInstallRequest( const RMessage2& aMessage );

        /**

        * C++ default constructor.

        * @param aMessage - Message object having this request.

        */

        CSWInstInstallRequest( TInt aObjectId );

        /**

        * 2nd phase constructor.

        */

        void ConstructL();

        /**

        * Handles the error when installation of the given package is not supported.

        * @since 3.0

        * @param aFileName - File name of the package.

        */

        void HandleNotSupportedL( const TDesC& aFileName ) const;

        /**

        * Performs the actual installation.

        * @since 3.0

        * @param aFile - Handle to the package.

        */

        void DoInstallL( RFile& aFile);   

        /**

        * Gets MIME type of the package.

        * @since 3.0

        * @param aContent - Package content.

        * @param aMIME - On return contains the MIME type of the package.

        */

        void GetMIMETypeL( const ContentAccess::CContent& aContent, TDes8& aMIME ); 

        /**

        * Helper to handle protected content.

        * @since 3.0

        * @param aFile - Handle to the package.

        * @param 

        * @return ETrue if rights exist and package can be installed.

        *         EFalse if the installation needs to be terminated.

        */

        TBool HandleProtectedContentL( RFile& aFile );

    private: // Data

        TInstallReq iParams;        

        TInstallOptions iOptions;

        RFile iFile;

        RFs iFs;        

    };

}

#endif      // SWINSTINSTALLREQUEST_H   

// End of File