Symbian3/PDK/Source/GUID-981C138C-1CF1-5D77-BEB5-81163AC71E44.dita
changeset 14 578be2adaf3e
parent 5 f345bda72bc4
--- a/Symbian3/PDK/Source/GUID-981C138C-1CF1-5D77-BEB5-81163AC71E44.dita	Tue Jul 20 12:00:49 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-981C138C-1CF1-5D77-BEB5-81163AC71E44.dita	Fri Aug 13 16:47:46 2010 +0100
@@ -1,100 +1,100 @@
-<?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 &lt;featureUID&gt; with a real Uid ) 
-#include &lt;featurecontrol.h&gt;
-#include &lt;featureinfo.h&gt; // 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>
+<?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 &lt;featureUID&gt; with a real Uid ) 
+#include &lt;featurecontrol.h&gt;
+#include &lt;featureinfo.h&gt; // 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>
 </related-links></task>
\ No newline at end of file