/*
* Copyright (c) 2007 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:   Class used to check the protection of the 
*                media files.
*
*/



#ifndef MEDIAFILEPROTECTION_H
#define MEDIAFILEPROTECTION_H

#include "mediafiledialogutils.h"
#include "mediafilevariation.h"

//  INCLUDES

#include <e32base.h>
#include <DRMHelper.h>
#include <apgcli.h>   // RApaLsSession


// CONSTANTS


//	FORWARD DECLARATIONS



/**
* CMFProtectionHandler
* 
* For gettting media file protection information (eg drm protection).
* If media is protected and does not have necessary rights it cannot
* be used eg as ringing tone. 
*
*/
NONSHARABLE_CLASS (CMFProtectionHandler) : public CBase
    {
    public:
    // enumeration which tells what is the file used for.
    enum TIntention
        {
        EPlay,
        ESelect
        };
    
    public:// Constructors and destructor

        /**
        * Two-phased constructor.
        */
		static CMFProtectionHandler* NewL();
        
        /**
        * Destructor.
        */
        virtual ~CMFProtectionHandler();
    
    private:

        /**
        * C++ default constructor.
        */
        CMFProtectionHandler();
	
        /**
        * By default Symbian OS constructor is private.
        */
        void ConstructL();

    public: // Functions from base classes

        /**
        * Checks if an unprotected file is valid.
        * @param aFileName Full path and filename.
        * @param aIntention Describes what the file is used for.
        * @return ETrue if the file is valid for intended use.
        */
        TBool IsFileValidL( const TDesC& aFileName, TIntention aIntention );
        TBool IsFileValid( const TDesC& aFileName, TIntention aIntention );
        TBool IsVideoValidL( const TDesC& aFileName, TIntention aIntention );
        TBool IsVideoValid( const TDesC& aFileName, TIntention aIntention );

        void SetAttrL( TInt aAttr, TInt aValue );
        void SetAttrL( TInt aAttr, const TDesC& aValue );
        

    private:
        /**
        * Return media file type
        */
        //TInt32 MediaFileType( const TDesC& aFileName );

        /**
        * Set the automated content type
        * @param  aAutomatedType: type of automated content
        */
        void SetAutomatedType(
             CDRMHelper::TDRMHelperAutomatedType aAutomatedType );

    private:

        /**
        * Displays an error note.
        * @param @aResourceId Resource ID
        */
        void ShowErrorNoteL( TInt aResourceId );

        /**
        * Checks if an unprotected file is valid.
        * @param aFileName Full path and filename.
        * @param aIntention Describes what the file is used for.
        * @return ETrue if the file is valid for intended use.
        */
        TBool IsFileValidUnprotectedL(
              const TDesC& aFileName, TIntention aIntention );

        /**
        * Returns info whether demoplay is allowed for given filetype
        * @param aDataType Tone MIME type
        * @return ETrue if tone allowed to be played
        */
        //TBool AllowDemoPlay( const TDesC& aDataType );

        /**
        * Returns info whether given filetype is allowed as ringingtone
        * @param aDataType Tone MIME type
        * @return ETrue if tone is allowed to be selected
        */
        //TBool AllowSelect( const TDesC& aDataType ) const;

        /**
        * Finds out the MIME type of a given file
        * @param aFileName File to be checked
        * @return Returns datatype of a file
        */
        TDataType DataTypeL( const TDesC& aFileName );
        
        /**
        * Finds out DRM restrictions for a given file
        * @param aFileName File to be checked
        * @param aInfoBits(out) Determines CFM protection
        * @return Returns EFalse if file is corrupted or has no rights
        */
        TBool GetFileInfoL( const TDesC& aFileName, TInt32& aInfoBits );

        /**
        * Checks if file is WMDRM protected.
        * @param aFileName Name of the file to be checked.
        * @return ETrue if file is WMDRM protected, EFalse otherwise.
        */
        TBool   IsFileWMDRMProtectedL( const TDesC& aFileName );
        
        TBool CheckFileSize( const TDesC& aFile, const TDesC& aMimeType );


    private:
        // DRM common functions
        DRMCommon* iDRMCommon;

        // DRM helper
        CDRMHelper* iDRMHelper;
        
        // for finding out drive type (eg memory card)
        CDriveUtil* iDriveUtil;
        
        // for media file list variation
        CMediaFileDialogVariation* iVariation;
          
        // Automated content type
        CDRMHelper::TDRMHelperAutomatedType iAutomatedType;
        
        // max file size
        TInt iMaxFileSize;
        
        // excluded mime types 
        CMimeTypeList* iExcludedMimeTypes;
        
        RApaLsSession iApaLsSession;
        RFs iFsSession;

    };
    

    


#endif  // MEDIAFILEPROTECTION_H

// End of File