/*

* Copyright (c) 2004-2009 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 "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: 

* CControllerInfo - a class associating a hash value and a version. 

* It is used to contain the hash value  and the verion of a particular sis controller  

*

*/

/**

 @file 

 @released

 @internalComponent

*/

#ifndef __CONTROLLERINFO_H__

#define __CONTROLLERINFO_H__

#include <e32base.h>

#ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK

#include "scrhelperutil.h"

#endif

class RReadStream;

class RWriteStream;

namespace Swi

{

class CHashContainer;

class CControllerInfo : public CBase

	{

public:

	IMPORT_C static CControllerInfo* NewL(TVersion aVersion, 

		const CHashContainer& aHashContainer, TInt aOffset);

	IMPORT_C static CControllerInfo* NewLC(TVersion aVersion, 

		const CHashContainer& aHashContainer, TInt aOffset);

	IMPORT_C static CControllerInfo* NewL(RReadStream& aStream);

	IMPORT_C static CControllerInfo* NewLC(RReadStream& aStream);

	IMPORT_C static CControllerInfo* NewL(const CControllerInfo& aControllerInfo);

	IMPORT_C static CControllerInfo* NewLC(const CControllerInfo& aControllerInfo);

 	/* This set of contructors effectively deprecated */

 	IMPORT_C static CControllerInfo* NewL(TVersion aVersion, const CHashContainer& aHashContainer);

 	IMPORT_C static CControllerInfo* NewLC(TVersion aVersion, const CHashContainer& aHashContainer);

	virtual ~CControllerInfo();

	/**

	 * Write the object content to a stream 

	 *

	 * @param aStream The stream to write to

	 */

	IMPORT_C void ExternalizeL(RWriteStream& aStream) const;

	/**

	 * Read the object content from a stream - initialize from a stream

	 *

	 * @param aStream The stream to read from

	 */

	IMPORT_C void InternalizeL(RReadStream& aStream);

	/**

	 * Provides the version of the controller object

	 *

	 * @return The version of the controller object

	 */

	TVersion Version() const;

 	/**

 	 * Provides the offset in the registry entry this controller is stored at

 	 *

 	 *

 	 * @return The offset of the controller in the registry

 	 *

 	 */

 	TInt Offset() const;

	/**

	 * Provides constant reference to the hash container of the controller object

	 *

	 * @return constant reference to the hash container of the controller object

	 */

	const CHashContainer& HashContainer() const;

#ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK

public: // Friend Functions

	friend void ScrHelperUtil::WriteToScrL(Usif::RSoftwareComponentRegistry& aScrSession, const Usif::TComponentId aCompId, CControllerInfo& aControllerInfo, TInt aIndex);

	friend void ScrHelperUtil::ReadFromScrL(Usif::RSoftwareComponentRegistry& aScrSession, const Usif::TComponentId aCompId, CControllerInfo*& aControllerInfo, TInt aIndex);

#endif

private:

 	CControllerInfo(TVersion aVersion, TInt aOffset);

	CControllerInfo();

	void ConstructL(const CHashContainer& aHashContainer);

	void ConstructL(RReadStream& aReadStream);

	void ConstructL(const CControllerInfo& aControllerInfo);

private:

	TVersion iVersion;

 	TInt iOffset;	

	CHashContainer* iHashContainer;

	};

inline TVersion CControllerInfo::Version() const

	{

	return iVersion;

	}

inline TInt CControllerInfo::Offset() const

 	{

 	return iOffset;

 	}

inline const CHashContainer& CControllerInfo::HashContainer() const

	{

	return *iHashContainer;

	}

} // namespace

#endif //__CONTROLLERINFO_H__