--- a/Symbian3/PDK/Source/GUID-981C138C-1CF1-5D77-BEB5-81163AC71E44.dita Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-981C138C-1CF1-5D77-BEB5-81163AC71E44.dita Tue Mar 30 11:56:28 2010 +0100
@@ -9,7 +9,15 @@
-->
<!DOCTYPE task
PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
-<task xml:lang="en" id="GUID-981C138C-1CF1-5D77-BEB5-81163AC71E44"><title>Reporting on all Features on a Device Dynamically Using RFeatureControl </title><shortdesc>How to list all supported features on a device using <apiname>RFeatureControl</apiname> 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">
+<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
@@ -19,31 +27,74 @@
// 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">
+</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">
+</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">
+</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">
+</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">
+</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> </related-links></task>
\ No newline at end of file
+</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>
+</related-links></task>
\ No newline at end of file