1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/persistentdata/featuremgmt/featureregistry/inc/featreg.h	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,109 @@
     1.4 +// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +// Public interface for querying support for features on a device, and
    1.18 +// subscribing for notification if any features are added or removed.
    1.19 +// 
    1.20 +//
    1.21 +
    1.22 +#ifndef FEATREG_H
    1.23 +#define FEATREG_H
    1.24 +
    1.25 +/**
    1.26 + * Interface for inquiring whether features are supported on the device.
    1.27 + *
    1.28 + * The code segment below shows an example of how the QuerySupport() API 
    1.29 + * should be used in client code that checks feature status. 
    1.30 + *   
    1.31 + * @code
    1.32 + *  
    1.33 + *  // Single query 
    1.34 + *  // 
    1.35 + *  TBool haveUsb = RFeatureRegistry::QuerySupportS(NFeature::KUsb) > 0;
    1.36 + *  if (haveUsb)
    1.37 + *    { // ... connect to USB service ...
    1.38 + *    }  
    1.39 + *
    1.40 + *  // or Multiple queries
    1.41 + *  // 
    1.42 + *  RFeatureRegistry featReg;
    1.43 + *  const TBool opened = (featReg.Open() == KErrNone);
    1.44 + *  iHaveUsb = opened && (featReg.QuerySupport(NFeature::KUsb) > 0);
    1.45 + *  iHaveBluetooth = opened && (featReg.QuerySupport(NFeature::KBluetooth) > 0);
    1.46 + *  featReg.Close(); // can always call Close(), even if Open() failed:
    1.47 + *  // ... proceed to update application menus based on these featue flags
    1.48 + *  
    1.49 + * @endcode 
    1.50 + *  
    1.51 + * Note the QuerySupport() API can return a negative error code. Clients 
    1.52 + * calling this API need to decide if this should result in specific error 
    1.53 + * handling or whether ignoring the error and assuming the feature is not
    1.54 + * supported is the best policy.
    1.55 + * 
    1.56 + * @see RFeatureRegistry::QuerySupportS      
    1.57 + * @publishedPartner
    1.58 + * @deprecated
    1.59 + */
    1.60 +NONSHARABLE_CLASS(RFeatureRegistry)
    1.61 +	{
    1.62 +public:
    1.63 +	/**
    1.64 +	 * Bit assignments in status word for listed features
    1.65 +	 *
    1.66 + 	 * @internalComponent
    1.67 +     */
    1.68 +	enum
    1.69 +		{
    1.70 +		EStatusSupportBit = 1, 
    1.71 +		EStatusUpgradableBit = 2
    1.72 +		};
    1.73 +	inline RFeatureRegistry();
    1.74 +	IMPORT_C TInt Open();
    1.75 +	IMPORT_C TInt QuerySupport(TUid aFeatureUid);
    1.76 +	IMPORT_C TInt QuerySupport(TUid aFeatureUid, TUint32& aInfo);
    1.77 +	IMPORT_C void Close();
    1.78 +
    1.79 +	IMPORT_C static TInt QuerySupportS(TUid aFeatureUid);
    1.80 +	IMPORT_C static TInt QuerySupportS(TUid aFeatureUid, TUint32& aInfo);
    1.81 +
    1.82 +private:
    1.83 +	class TImpl;
    1.84 +	TImpl* iImpl;
    1.85 +	};
    1.86 +
    1.87 +#ifndef SYMBIAN_FEATURE_MANAGER
    1.88 +/**
    1.89 + * Interface for obtaining notification of changes in the Feature Registry.
    1.90 + *
    1.91 + * @internalComponent
    1.92 + */
    1.93 + 
    1.94 +NONSHARABLE_CLASS(RFeatureRegistryNotify)
    1.95 +	{
    1.96 +public:
    1.97 +	inline RFeatureRegistryNotify();
    1.98 +	IMPORT_C TInt Open();
    1.99 +	IMPORT_C void Subscribe(TRequestStatus &aNotifyStatus);
   1.100 +	IMPORT_C void Cancel();
   1.101 +	IMPORT_C void Close();
   1.102 +
   1.103 +private:
   1.104 +	class TImpl;
   1.105 +	TImpl* iImpl;
   1.106 +	};
   1.107 +
   1.108 +#endif
   1.109 +
   1.110 +#include <featreg.inl> 
   1.111 +
   1.112 +#endif