// 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:

// mw/remoteconn/mtpfws/mtpfw/dataproviders/dputility/inc/mmtpservicedataprovider.h

/**

 @file

 @internalTechnology

*/

#ifndef __MMTPSERVICEDATAPROVIDER_H__

#define __MMTPSERVICEDATAPROVIDER_H__

#include <mtp/mtpprotocolconstants.h>

class MMTPSvcObjectHandler;

class MMTPServiceHandler;

class CMTPTypeStorageInfo;

class MMTPServiceDataProvider

{

public:

	/**

	Get object handler pointer for request processor.

	@param aFormatCode Format code which owned by the returned object handler.

	@return MMTPSvcObjectHandler* object handler's pointer. If the pointer is 

	NULL, then means the input format code is not supported by the data provider.

	*/

	virtual MMTPSvcObjectHandler* ObjectHandler(TUint16 aFormatCode) const = 0;

	/**

	Get service handler pointer for request processor.

	@return MMTPServiceHandler* service handler's pointer. If the pointer is 

	NULL, then means data provider doesn't support service extension.

	*/

	IMPORT_C virtual MMTPServiceHandler* ServiceHandler() const;

	/**

	Check if a service property code is valid.

	@param aPropCode A service property code need to be checked.

	@return TBool ETrue is valid.

	*/

	IMPORT_C virtual TBool IsValidServicePropCodeL(TUint16 aPropCode) const;

	/**

	Check if a format code is valid.

	@param aFormatCode A format code need to be checked data provider.

	@return TBool ETrue is valid.

	*/

	virtual TBool IsValidFormatCodeL(TUint16 aFormatCode) const = 0;

	/**

	Check if a object property code is valid.

	@param aFormatCode A format code which the property code belong to.

	@param aPropCode A object property code need to be checked.

	@return TBool ETrue is valid.

	*/

	virtual TBool IsValidObjectPropCodeL(TUint16 aFormatCode, TUint16 aPropCode) const = 0;

	/**

	Get service id owned by a data provider.

	@return TUint32 Service id.

	*/

	IMPORT_C virtual TUint32 ServiceID() const;

	/**

	Get storage id owned by a data provider.

	@return TUint32 Storage id.

	*/

	virtual TUint32 StorageId() const = 0;

	/**

	Get the AO's granularity for delete all objects and get object proper list. 

	@return TUint32 Operation granularity, normally the value is 50.

	*/

	IMPORT_C virtual TUint32 OperationGranularity() const;

	/**

	Dispatch GetStorageInfo to data provider

	@param aStorageInfo StorageInfo dataset.

	@return See MTP response code definition

	@leave One of the system wide error codes, if a general processing error

	*/

	virtual TMTPResponseCode GetStorageInfoL(CMTPTypeStorageInfo& aStorageInfo) const = 0;

};

#endif // __MMTPSERVICEDATAPROVIDER_H__