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

// Public interface for querying support for features on a device, and

// subscribing for notification if any features are added or removed.

// 

//

#ifndef FEATREG_H

#define FEATREG_H

/**

 * Interface for inquiring whether features are supported on the device.

 *

 * The code segment below shows an example of how the QuerySupport() API 

 * should be used in client code that checks feature status. 

 *   

 * @code

 *  

 *  // Single query 

 *  // 

 *  TBool haveUsb = RFeatureRegistry::QuerySupportS(NFeature::KUsb) > 0;

 *  if (haveUsb)

 *    { // ... connect to USB service ...

 *    }  

 *

 *  // or Multiple queries

 *  // 

 *  RFeatureRegistry featReg;

 *  const TBool opened = (featReg.Open() == KErrNone);

 *  iHaveUsb = opened && (featReg.QuerySupport(NFeature::KUsb) > 0);

 *  iHaveBluetooth = opened && (featReg.QuerySupport(NFeature::KBluetooth) > 0);

 *  featReg.Close(); // can always call Close(), even if Open() failed:

 *  // ... proceed to update application menus based on these featue flags

 *  

 * @endcode 

 *  

 * Note the QuerySupport() API can return a negative error code. Clients 

 * calling this API need to decide if this should result in specific error 

 * handling or whether ignoring the error and assuming the feature is not

 * supported is the best policy.

 * 

 * @see RFeatureRegistry::QuerySupportS      

 * @publishedPartner

 * @deprecated

 */

NONSHARABLE_CLASS(RFeatureRegistry)

	{

public:

	/**

	 * Bit assignments in status word for listed features

	 *

 	 * @internalComponent

     */

	enum

		{

		EStatusSupportBit = 1, 

		EStatusUpgradableBit = 2

		};

	inline RFeatureRegistry();

	IMPORT_C TInt Open();

	IMPORT_C TInt QuerySupport(TUid aFeatureUid);

	IMPORT_C TInt QuerySupport(TUid aFeatureUid, TUint32& aInfo);

	IMPORT_C void Close();

	IMPORT_C static TInt QuerySupportS(TUid aFeatureUid);

	IMPORT_C static TInt QuerySupportS(TUid aFeatureUid, TUint32& aInfo);

private:

	class TImpl;

	TImpl* iImpl;

	};

#ifndef SYMBIAN_FEATURE_MANAGER

/**

 * Interface for obtaining notification of changes in the Feature Registry.

 *

 * @internalComponent

 */

NONSHARABLE_CLASS(RFeatureRegistryNotify)

	{

public:

	inline RFeatureRegistryNotify();

	IMPORT_C TInt Open();

	IMPORT_C void Subscribe(TRequestStatus &aNotifyStatus);

	IMPORT_C void Cancel();

	IMPORT_C void Close();

private:

	class TImpl;

	TImpl* iImpl;

	};

#endif

#include <featreg.inl> 

#endif