diff -r 48780e181b38 -r 578be2adaf3e Symbian3/PDK/Source/GUID-3C52315A-71CC-52B2-B809-F04E4078338D.dita --- a/Symbian3/PDK/Source/GUID-3C52315A-71CC-52B2-B809-F04E4078338D.dita Tue Jul 20 12:00:49 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-3C52315A-71CC-52B2-B809-F04E4078338D.dita Fri Aug 13 16:47:46 2010 +0100 @@ -1,98 +1,98 @@ - - - - - -Reporting -on Several Features Dynamically Using RFeatureControl How to query a feature set using RFeatureControl dynamically. -

To query whether -the features in a featuer set are supported using RFeatureControl dynamically, -take the following steps.

- - -Create an instance of RFeatureControl, - -// replace <featureUID> with a real Uid ) -#include <featurecontrol.h> -#include <featureinfo.h> // for feature definitions -CMyClass::MyMethodL() - { - // Replace KFeatureUidx with real feature Uid. - // Open() must be called before calling any other methods. - // Disconnect is done by calling the Close() method. - RFeatureControl featureControl; - - -call its Open() function, - - TInt err = featureControl.Open(); - - - -determine the features you want a report on, - - -create an instance of RFeatureArray (an array of TFeatureEntry objects), - - if ( err == KErrNone ) - { - // Query multiple features statuses (single IPC-call, so less overhead) - RFeatureArray Uids; - CleanupClosePushL(Uids); - - - -append the Uid of each feature entry to the array, - - Uids.AppendL( KFeatureUid1 ); - Uids.AppendL( KFeatureUid2 ); - - - -call the FeaturesSupported() function of the RFeatureControl object -with a reference to the feature array as argument, and - - TInt err = control.FeaturesSupported( Uids ); - - - -call the Close() function of the RFeatureControl object. - - // Remember to call CloseL after using RFeatureControl. - // It disconnects the Feature Manager server. - featureControl.Close(); - } - - - -

FeatureSupported() returns:

    -

  • KErrNone if -the status of each feature was fetched successfully,

    • -

  • KErrArgument if -the array was empty, and

    • -

  • otherwise returns an -error code.

    • -

If any of the feature entries in the array does not exist, the call -to FeatureSupported() removes the feature entry Uid from -the list. To discover whether a feature entry exists, call the Find() function -of RFeatureArray with the Uid of the entry as argument. -To discover whether a feature which exists is also enabled, query its EFeatureEnabled status -bit.

- -Reporting - Feature Data for a Single Feature Dynamically Using RFeatureControl - -Reporting -on all Features on a Device Dynamically Using RFeatureControl - -Feature Manager -Collection Overview -Feature Manager -ReportingTutorials + + + + + +Reporting +on Several Features Dynamically Using RFeatureControl How to query a feature set using RFeatureControl dynamically. +

To query whether +the features in a featuer set are supported using RFeatureControl dynamically, +take the following steps.

+ + +Create an instance of RFeatureControl, + +// replace <featureUID> with a real Uid ) +#include <featurecontrol.h> +#include <featureinfo.h> // for feature definitions +CMyClass::MyMethodL() + { + // Replace KFeatureUidx with real feature Uid. + // Open() must be called before calling any other methods. + // Disconnect is done by calling the Close() method. + RFeatureControl featureControl; + + +call its Open() function, + + TInt err = featureControl.Open(); + + + +determine the features you want a report on, + + +create an instance of RFeatureArray (an array of TFeatureEntry objects), + + if ( err == KErrNone ) + { + // Query multiple features statuses (single IPC-call, so less overhead) + RFeatureArray Uids; + CleanupClosePushL(Uids); + + + +append the Uid of each feature entry to the array, + + Uids.AppendL( KFeatureUid1 ); + Uids.AppendL( KFeatureUid2 ); + + + +call the FeaturesSupported() function of the RFeatureControl object +with a reference to the feature array as argument, and + + TInt err = control.FeaturesSupported( Uids ); + + + +call the Close() function of the RFeatureControl object. + + // Remember to call CloseL after using RFeatureControl. + // It disconnects the Feature Manager server. + featureControl.Close(); + } + + + +

FeatureSupported() returns:

    +

  • KErrNone if +the status of each feature was fetched successfully,

    • +

  • KErrArgument if +the array was empty, and

    • +

  • otherwise returns an +error code.

    • +

If any of the feature entries in the array does not exist, the call +to FeatureSupported() removes the feature entry Uid from +the list. To discover whether a feature entry exists, call the Find() function +of RFeatureArray with the Uid of the entry as argument. +To discover whether a feature which exists is also enabled, query its EFeatureEnabled status +bit.

+ +Reporting + Feature Data for a Single Feature Dynamically Using RFeatureControl + +Reporting +on all Features on a Device Dynamically Using RFeatureControl + +Feature Manager +Collection Overview +Feature Manager +ReportingTutorials \ No newline at end of file