<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 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: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-981C138C-1CF1-5D77-BEB5-81163AC71E44" xml:lang="en"><title>Reporting

on all Features on a Device Dynamically Using RFeatureControl </title><shortdesc>How to list all supported features on a device using <codeph>RFeatureControl</codeph> dynamically. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context id="GUID-66CE0C50-75D0-547E-869C-8D0BFEBE0974"><p>To list all supported

features on a device using <xref href="GUID-F6AAAC24-4A62-383A-86C6-2E46335C3FD4.dita"><apiname>RFeatureControl</apiname></xref> dynamically,

take the following steps. </p> </context>

<steps id="GUID-0C573781-0002-500B-A7F4-E44CC688A820">

<step id="GUID-B65FF1CA-5A11-563E-B0A3-9DDD2E555276"><cmd/>

<info>Create an instance of <xref href="GUID-F6AAAC24-4A62-383A-86C6-2E46335C3FD4.dita"><apiname>RFeatureControl</apiname></xref>, </info>

<stepxmp><codeblock id="GUID-0F3730FF-00DC-5FCD-9A0C-CA205082A5B1" xml:space="preserve">

// 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;

</codeblock> </stepxmp>

</step>

<step id="GUID-A4FEB01F-56A0-595C-85A5-5C2E435BD175"><cmd/>

<info>call its <xref href="GUID-20D0D10F-3401-3F72-8AF6-DC35F6025DC2.dita"><apiname>Open()</apiname></xref> function, </info>

<stepxmp><codeblock id="GUID-61D3CB3F-1760-5747-8F55-6595BAF66AAB" xml:space="preserve">

     TInt err = featureControl.Open();

</codeblock> </stepxmp>

</step>

<step id="GUID-DAFA2032-8535-5F63-AD1B-D83D843FB271"><cmd/>

<info>create an instance of <xref href="GUID-144E257F-A162-3680-B1C5-C28BEAA902BC.dita"><apiname>RFeatureArray</apiname></xref> (an array of <xref href="GUID-80C51259-F2C4-3877-97B4-EC0C85DE93DE.dita"><apiname>TFeatureEntry</apiname></xref> objects), </info>

<stepxmp><codeblock id="GUID-3CAE75C5-A1B6-51B9-AD2C-2E13AE53FD8E" xml:space="preserve">

         // List all supported features.

         // A client owned RFeatureUidArray array which will be filled with 

         // the UIDs of supported features. 

         RFeatureUidArray supportedFeatures;

</codeblock> </stepxmp>

</step>

<step id="GUID-9BD96024-5335-5A54-832A-0A87B293B24A"><cmd/>

<info>call its <xref href="GUID-5647EEB3-56CB-35C9-B9E1-1E348644A27A.dita"><apiname>ListSupportedFeatures()</apiname></xref> function with a

reference to the <xref href="GUID-144E257F-A162-3680-B1C5-C28BEAA902BC.dita"><apiname>RFeatureArray</apiname></xref> as argument, </info>

<stepxmp><codeblock id="GUID-6B1D8B91-76D2-575E-91AE-93727C75FA89" xml:space="preserve">

         // ListSupportedFeatures() returns one of the Symbian error codes.

         err = featureControl.ListSupportedFeatures( supportedFeatures );

         // do something

</codeblock> </stepxmp>

</step>

<step id="GUID-8BF96CBE-BB74-58A3-A63B-8AC32F71D78C"><cmd/>

<info>call its <xref href="GUID-01D2AF56-21E1-3FF3-BF86-0C356A1658EF.dita"><apiname>Close()</apiname></xref> function, </info>

<stepxmp><codeblock id="GUID-C8126829-41FA-50B2-B462-9F92090B5146" xml:space="preserve">

         // Closes the array and frees all memory allocated to the array.

         supportedFeatures.Close();

</codeblock> </stepxmp>

</step>

<step id="GUID-AAB93851-F12D-52A8-BAC5-00B78C09024C"><cmd/>

<info>call the <xref href="GUID-01D2AF56-21E1-3FF3-BF86-0C356A1658EF.dita"><apiname>Close()</apiname></xref> function of the RFeatureArray object. </info>

<stepxmp><codeblock id="GUID-475D7629-1E07-5269-8F11-75756C04FE26" xml:space="preserve">

         // Remember to call CloseL after using RFeatureControl.

         // It disconnects the Feature Manager server.

         featureControl.Close();  

         }

     }

</codeblock> </stepxmp>

</step>

</steps>

<result id="GUID-2FDD0EEF-AE71-5078-8A53-2ECB603D30E8"><p> <xref href="GUID-5647EEB3-56CB-35C9-B9E1-1E348644A27A.dita"><apiname> ListSupportedFeatures()</apiname></xref> causes

the passed in array to be filled with the Uids of supported features. It returns: </p> <ul>

<li id="GUID-8B1E55A0-20C0-5C72-93B4-2C1828633192"><p> <xref href="GUID-6CA4F1ED-7947-3087-B618-D35858FAA3BC.dita"><apiname>KErrNone</apiname></xref> if

the <xref href="GUID-144E257F-A162-3680-B1C5-C28BEAA902BC.dita"><apiname>RFeatureArray</apiname></xref> was successfully filled with Uids, </p> </li>

<li id="GUID-AA416C1E-E619-5637-905B-27ADD3A09AD9"><p> <xref href="GUID-E306B54A-1F34-3FB0-B515-90D647B7B822.dita"><apiname>KServerBusy</apiname></xref> if

the call failed because features were being enabled or disabled (so creating

a lock), and </p> </li>

<li id="GUID-0462B50E-A799-562E-9B8E-8EA5C1DD1F8A"><p>otherwise returns an

error code. </p> </li>

</ul> </result>

</taskbody><related-links>

<link href="GUID-BE841768-0F22-5B9D-B783-B02C74E89AFB.dita"><linktext>Reporting

Feature Data for a Single                 Feature Dynamically Using RFeatureControl</linktext>

</link>

<link href="GUID-3C52315A-71CC-52B2-B809-F04E4078338D.dita"><linktext>Reporting

on Several Features                 Dynamically Using RFeatureControl</linktext>

</link>

<link href="GUID-B71AC5E3-8AA8-55AD-916F-9E873926011B.dita"><linktext>Feature Manager

Collection Overview</linktext></link>

<link href="GUID-F2489DE2-18E2-5C5B-A174-49B5B7A64A7C.dita"><linktext>Feature Manager

ReportingTutorials</linktext></link>