// Copyright (c) 2006-2009 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:
//

/**
 @file
 @publishedPartner
 @released
*/

#ifndef CMTPOBJECTMETADATA_H
#define CMTPOBJECTMETADATA_H

#include <mtp/cmtpmetadata.h>

/** 
Defines the MTP object meta-data.
@publishedPartner
@released
*/
class CMTPObjectMetaData : public CMTPMetaData
{
public:

    /**
    MTP object meta-data element identifiers.
    */      
    enum TElementId
        {        
        /**
        The ID of the data provider responsible for the data object. This 
        element is of type @see TUint.
        */
        EDataProviderId     = 0,
        
        /**
        The object format code. This element is of type @see TUint.
        */
        EFormatCode         = 1,
        
        /**
        The object format sub-code. Currently this field is ignored unless the 
        @see EFormatCode contains a value of @see EMTPFormatCodeAssociation, in 
        which case this field should the specify the MTP association type code.
        This element is of type @see TUint.
        */
        EFormatSubCode      = 2,
        
        /**
        The object handle. This element is of type @see TUint.
        */
        EHandle             = 3,
        
        /**
        The set of MTP operational modes in which the object is visible and 
        will be enumerated to a connected MTP Initiator. The MTP operational
        modes are represented as a set of @see TMTPOperationalMode bit flags.
        This element is of type @see TUint 
        */
        EModes              = 4,
        
        /**
        The parent object handle. This element is of type @see TUint.
        */
        EParentHandle       = 5,
        
        /**
        The MTP storage ID of the storage on which the data object resides. 
        This element is of type @see TUint.
        */
        EStorageId          = 6,
        
        /**
        The MTP storage ID of the storage on which the data object resides. 
        This element is of type @see TUint.
        */
        EStorageVolumeId    = 7,
        
        /**
        The data object's System Unique IDentifier (SUID). This element is of 
        type @see TDesC&.
        */
        ESuid               = 8,

		/**
		The data object's user rating
		This element is of type @see TUint.
		@deprecated
		*/
		EUserRating = 9,

		/** 
		The data object's BuyNow flag
		This element is of type @see TUint.
		@deprecated
		*/
		EBuyNow = 10,

		/** The data object's Played flag
		This element is of type @see TUint.
		@deprecated
		*/
		EPlayCount = 11,
		
		/**
		The data Objects Identifier as in HandleStore table
		This element is of type @see TUint.
		*/
		EIdentifier = 12,
		
		/**
		The id related to ParentHandle
		This element is of type @see TUint.
		*/
		//EParentId = 13,
		
		/**
		The flag, used in object modification, indicates if the modified object
		should be reported to initiator
		This element is of type @see TUint.
		*/
		ENonConsumable = 13,
		
		EObjectMetaDataUpdate = 14,	

		EName = 15,
        /**
        The number of elements.        
        */
        ENumElements,
        };

public:
    
    IMPORT_C static CMTPObjectMetaData* NewL();
    IMPORT_C static CMTPObjectMetaData* NewLC();
    IMPORT_C static CMTPObjectMetaData* NewL(TUint aDataProviderId, TUint aFormatCode, TUint aStorageId, const TDesC& aSuid);
    IMPORT_C static CMTPObjectMetaData* NewLC(TUint aDataProviderId, TUint aFormatCode, TUint aStorageId, const TDesC& aSuid);
    IMPORT_C ~CMTPObjectMetaData();
    
private:
    
    CMTPObjectMetaData();
    void ConstructL();
    void ConstructL(TUint aDataProviderId, TUint aFormatCode, TUint aStorageId, const TDesC& aSuid);
    /* @deprecated */
    void ConstructL( const TDesC& aSuid, TUint aUserRating, TUint aBuyNow, TUint aPlayCount);

public:
	/* @deprecated */
    IMPORT_C static CMTPObjectMetaData* NewL(const TDesC& aSuid, TUint aUserRating, TUint aBuyNow, TUint aPlayCount );
    /* @deprecated */
    IMPORT_C static CMTPObjectMetaData* NewLC(const TDesC& aSuid, TUint aUserRating, TUint aBuyNow, TUint aPlayCount );
    
private:  // Owned
    
    /**
    The element meta-data.
    */
    static const TElementMetaData   KElements[];
};

#endif // CMTPOBJECTMETADATA_H