/*

* Copyright (c) 2005 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:Provides functions for finding resource files.

*

*/

#ifndef POSLMFILEFINDER_H

#define POSLMFILEFINDER_H

// INCLUDES

#include <f32file.h>

// CONSTANTS

// FORWARD DECLARATIONS

// CLASS DECLARATION

/**

* Provides functions for finding resource files.

*/

class PosLmFileFinder

    {

    public:  // New functions

        /* Searches all installed drives for a localized

        * resource file. The filename is set to the resource file.

        * Drive C: is searched first, then A: to Z: if they are available.

        * @param aFilename Path to the localized resource file.

        * @param aFileSession A file session.

        * @param aResourceFieName Name of resource file.

        * @return Returns KErrNotFound if the resource cannot be found on any

        *   drive, KErrNone otherwise.

        */

        IMPORT_C static TInt ResourceFileL(

        /* IN/OUT */       TFileName* aFilename,

        /* IN  */       RFs& aFileSession,

        /* IN  */       const TDesC& aResourceFileName

        );

    private:

        /**

        * Checks if the resource file can be found on the specified drive.

        * @param aDrive A drive to search.

        * @param aFilename File name (and path) to the resource file if found.

        * @param aFileSession A file session.

        * @param aResourceFieName Name of resource file.

        * @return ETrue if resource file is found on specified drive,

        *   EFalse otherwise.

        */

        static TBool IsResourceOnDriveL(

        /* IN */        TInt aDrive,

        /* IN/OUT */       TFileName* aFilename,

        /* IN  */       RFs& aFileSession,

        /* IN  */       const TDesC& aResourceFileName

        );

    };

#endif      // POSLMFILEFINDER_H

// End of File