/*
* 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:      Utility for working with files in upnp context
*
*/






#ifndef UPNPFILEUTILITY_H
#define UPNPFILEUTILITY_H

//  INCLUDES
#include <e32base.h>

// FORWARD DECLARATIONS
class CUpnpElement;

// CLASS DECLARATION

/**
* Utility for working with local files in upnp context. The class
* contains static methods that can be used to check various things
* related to downloading files to local filesystem, or when playing
* local files via upnp.
*
* @lib upnpavcontrollerhelper.lib
* @since S60 3.2
*/
class UPnPFileUtility
    {

public: // Business logic methods

    /**
     * Checks if given file content is protected.
     * Note that if a file is protected, it can not be copied to
     * a remote upnp mediaserver, nor it can be played via a remote
     * renderer. A client should use this interface before attempting
     * any of these operations for usability sake.
     * Currently supports checks for OEM-DRM and WM-DRM.
     * The method will leave if the file is not found, or if the
     * protection status can not be checked for some reason.
     *
     * @since S60 3.2
     * @param aFilePath full path to file
     * @return ETrue if file is protected 
     */
    IMPORT_C static TBool IsFileProtectedL(
        const TDesC& aFilePath );

    /**
     * Checks if the given remote object (and the given particular
     * resource) can fit in memory when downloaded using current
     * default copy target setting
     * @since S60 3.2
     *
     * @param aResource the resource to download
     * @return EFalse if the target drive does not have enough space
     */
    IMPORT_C static TBool FitsInMemory(
        const CUpnpElement& aResource );

private:
    
    /**
     * Checks if the given remote object (and the given particular
     * resource) can fit in memory when downloaded using current
     * default copy target setting
     * @since S60 3.2
     *
     * @param aResource the resource to download
     * @return EFalse if the target drive does not have enough space
     */
    static TBool FitsInMemoryL(
        const CUpnpElement& aResource );
    
    };



#endif  // UPNPFILEUTILITY_H

// End of File