CFeatureDiscovery Class Reference

#include <featdiscovery.h>

Link against: featdiscovery.lib

class CFeatureDiscovery : public CBase

Inherits from

CFeatureDiscovery
- CBase

Public Member Functions
virtual	~CFeatureDiscovery()
IMPORT_C TInt	FeaturesSupported(TFeatureSet &)
IMPORT_C void	FeaturesSupportedL(TFeatureSet &)
IMPORT_C TBool	IsFeatureSupportedL(TInt)
IMPORT_C TBool	IsFeatureSupportedL(TUid)
IMPORT_C TBool	IsSupported(TInt)
IMPORT_C TBool	IsSupported(TUid)
IMPORT_C CFeatureDiscovery *	NewL()
IMPORT_C CFeatureDiscovery *	NewLC()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

The feature discovery API provides methods which are used to query which features are supported in the environment.

Constructor & Destructor Documentation

~CFeatureDiscovery ( )

~CFeatureDiscovery

(

)

[virtual]

Destructor.

Member Function Documentation

FeaturesSupported ( TFeatureSet & )

IMPORT_C TInt

FeaturesSupported

(

TFeatureSet &

aFeatures

)

const

Dynamic method to query the supported status of a set of features on the device. Before calling the method an instance of the CFeatureDiscovery class need to be created by using one of the factory methods, NewL() or NewLC(). The created instance must be deleted after use.

Parameters
aFeatures	is the wrapper class for feature array queried.

Return Value: KErrNone if status query succeeded. Otherwise one of the Symbian OS error codes

FeaturesSupportedL ( TFeatureSet & )

IMPORT_C void

FeaturesSupportedL

(

TFeatureSet &

aFeatures

)

[static]

Static method to query the supported status of a set of features on the device.

Parameters
aFeatures	is the wrapper class for feature array queried.

Leave Codes
Any	One of the Symbian OS system-wide error codes

IsFeatureSupportedL ( TInt )

IMPORT_C TBool

IsFeatureSupportedL

(

TInt

aFeature

)

[static]

Static method to query the supported status of a feature on the device.

DeprecatedUse IsFeatureSupportedL(TUid aFeature) instead.

Parameters
aFeature	is the feature ID of the feature that is queried.

Return Value: a TBool indicating whether the feature is supported (ETrue) or not (EFalse). If the feature does not exist, the return value is EFalse.

Leave Codes
Any	One of the Symbian OS system-wide error codes

IsFeatureSupportedL ( TUid )

IMPORT_C TBool

IsFeatureSupportedL

(

TUid

aFeature

)

[static]

Static method to query the supported status of a feature on the device.

Parameters
aFeature	is the feature UID of the feature that is queried.

Return Value: a TBool indicating whether the feature is supported (ETrue) or not (EFalse). If the feature does not exist, the return value is EFalse.

Leave Codes
Any	One of the Symbian OS system-wide error codes

IsSupported ( TInt )

IMPORT_C TBool

IsSupported

(

TInt

aFeature

)

const

Dynamic method to query the supported status of a feature on the device. Before calling the method an instance of the CFeatureDiscovery class must be created by using one of the factory methods, NewL() or NewLC(). The created instance must be deleted after use.

DeprecatedUse IsSupported(TUid aFeature) instead.

Parameters
aFeature	is the feature ID of the feature that is queried.

Return Value: a TBool indicating whether the feature is supported (ETrue) or not (EFalse). If the feature does not exist, the return value is EFalse.

IsSupported ( TUid )

IMPORT_C TBool

IsSupported

(

TUid

aFeature

)

const

Dynamic method to query the supported status of a feature on the device.

Before calling the method an instance of the CFeatureDiscovery class must be created by using one of the factory methods, NewL() or NewLC(). The created instance must be deleted after use.

Parameters
aFeature	is the feature UID of the feature that is queried.

Return Value: a TBool indicating whether the feature is supported (ETrue) or not (EFalse). If the feature does not exist, the return value is EFalse.

NewL ( )

IMPORT_C CFeatureDiscovery *

NewL

(

)

[static]

This is a two-phase constructor method that is used to create a new instance of the CFeatureDiscovery class.

Return Value: a pointer to a new instance of the CFeatureDiscovery class.

Leave Codes
Any	One of the Symbian OS system-wide error codes

NewLC ( )

IMPORT_C CFeatureDiscovery *

NewLC

(

)

[static]

This is a two-phase constructor method that is used to create a new instance of the CFeatureDiscovery class. This method leaves the instance of the object on the cleanup stack.

Return Value: a pointer to a new instance of the CFeatureDiscovery class.

Leave Codes
Any	One of the Symbian OS system-wide error codes