/*
* 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
* which accompanies this distribution, and is available
* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  Mount configuration entry
*
*/


#ifndef CRSFWMOUNTENTRY_H
#define CRSFWMOUNTENTRY_H

// INCLUDES
#include <e32base.h>
#include <f32file.h>
#include <rsfwmountentryitem.h>


// Drive entry constants
// these come from UI specification
const TInt KMaxMountNameLength = 20;
const TInt KMaxMountUriLength = 200;
const TInt KMaxMountUserNameLength = 50;
const TInt KMaxMountPasswordLength = 50;
const TInt KMaxMountAuxDataLength  = 64;
const TInt KMaxMountConfItemLength = 200; // Longest possible conf item value.
const TInt KMaxMountConfLength     = 512; // Buffer for sending all drive 
                                          // configuration values
const TInt KIndexAsStringLength = 4; // how wide string for index


// CLASS DECLARATION
/**
*  Remote drive (configuration) entry
*
*  Drive configuration entry consists of the following values:
*  - Index of the entry. Optional.
*  - Friendly name. Mandatory.
*  - Drive letter. Optional.
*  - Drive URL. Mandatory.
*  - User name. Optional.
*  - Password. Optional
*  - Internet Access point. Optional.
*
*  Maximum lengths for the strings:
*   - Friendly name 20 characters
*   - Drive URL 200 characters
*   - User name 50 characters
*   - Password 50 characters
*  Setter functions leave with KErrArgument, if longer values are attempted
*
*  Drive Letter must be between J: and Y:
*  (see also RFs::DriveList() documentation)¨
*
*  Drive Url must begin with a valid scheme (e.g. https:// or upnp://)
*
*  @lib mountstore.dll
*  @since Series 60 3.1
*/
class CRsfwMountEntry: public CBase
    {
public: // Constructors and destructor
    /**
     * Two-phased constructor.
     */
    IMPORT_C static CRsfwMountEntry* NewL();

    /**
     * Two-phased constructor
     */
    IMPORT_C static CRsfwMountEntry* NewLC();

    /**
     * Destructor.
     */
    IMPORT_C virtual ~CRsfwMountEntry();

    /**
     * Sets an item value
     * @param aIndex item index
     * @param aValue string value
     * @leave KErrArgument, incorrect index or value
     */
    IMPORT_C void SetItemL(TInt aIndex, const TDesC8& aValue);

    /**
     * Sets an item value
     * @param aIndex item index
     * @param aValue string value
     * @leave KErrArgument, incorrect index or value
     */
    IMPORT_C void SetItemL(TInt aIndex, const TDesC& aValue);

    /**
     * Sets all item values 
     * @param aIndex index (only used for positioning the entry - not stored)
     * @param aName name
     * @param aDriveLetter drive letter
     * @param aUri URI
     * @param aUserName user name
     * @param aPassword password
     * @param aIap IAP name
     * @leave KErrArgument, one or more parameters incorrect
     */
    IMPORT_C void SetEntryL(TInt aIndex,
                            const TDesC& aName,
                            TChar aDriveLetter,
                            const TDesC& aUrl,
                            const TDesC& aUserName,
                            const TDesC& aPassword,
                            const TDesC& aIap);

    /**
     * Returns an item value
     * An empty value may be an empty string or NULL
     */
    IMPORT_C const HBufC* Item(TInt aIndex) const;
    
    /**
     * Clear the entry - the items are set to NULL
     */
    IMPORT_C void Clear();

    /**
     * Clone the entry - the items are are copied to the newly created entry
     * @return cloned entry
     */
    IMPORT_C CRsfwMountEntry* CloneL() const;

private:
    CRsfwMountEntry();
    void ConstructL();

private: // Data
    RFs iFs;
    HBufC* iMountEntryItems[EMountEntryItemCount];
    };

#endif // CRSFWMOUNTENTRY_H

// End of File
