<?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-ADC42872-9A5B-50F2-8A33-6621A8F7C177" xml:lang="en"><title>Handling

Feature Notification </title><shortdesc>How to handle notification of changes to a feature using <codeph>RFeatureControl</codeph>. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context id="GUID-96D657EC-032D-535E-926A-924CB5D07324"><p>To handle notification

of changes to a feature using <xref href="GUID-F6AAAC24-4A62-383A-86C6-2E46335C3FD4.dita"><apiname>RFeatureControl</apiname></xref>, take the

following steps. </p><p/><p>  <xref href="GUID-623C4183-00F0-36B0-AE1F-5C5EDCAF1B3D.dita"><apiname>MFeatureObserver</apiname></xref> is an

interface which you implement to react to change notification in whatever

way you choose. It has two member functions which you must implement:   </p><p/><p><xref href="GUID-428DC6B1-6847-313F-BEEF-A8EC2442BA57.dita"><apiname>HandleNotifyChange()</apiname></xref> and</p><p><xref href="GUID-F737E1D7-5B67-345D-8290-E31F214D55E8.dita"><apiname>HandleNotifyError()</apiname></xref></p><p/><p>&lt;api-item&gt;HandleNotifyChange()&lt;/api-item&gt; takes two arguments: </p><p/><p>a <xref href="GUID-5F29338F-1073-3160-8FDD-E3FD4932F009.dita"><apiname>TFeatureChangeType</apiname></xref> representing

the kind of change you want to be notified of, and</p><p>a <xref href="GUID-80C51259-F2C4-3877-97B4-EC0C85DE93DE.dita"><apiname>TFeatureEntry</apiname></xref> object

representing the feature you want to be notified of when it is change. </p><p/><p> <xref href="GUID-F737E1D7-5B67-345D-8290-E31F214D55E8.dita"><apiname>HandleNotifyError()</apiname></xref> takes

one argument, an integer: this integer represents one of the Symbian platform

error codes. Any error in the notifier causes the notifier to stop handling

notifications. Your implementation should respond to each of the error types

you expect to occur.   </p> </context>

</taskbody><related-links>

<link href="GUID-2E33854B-5725-55DE-9B03-7A3100F5A5B5.dita"><linktext>Requesting

feature                 notification</linktext></link>

<link href="GUID-926862C4-5E13-5896-B959-0D408C748AB5.dita"><linktext>Cancelling

feature                 notification</linktext></link>

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

Collection Overview</linktext></link>

<link href="GUID-910780A3-D6AB-5EE2-966A-5F228AC5804F.dita"><linktext>Feature Manager

Notification Tutorials</linktext></link>

</related-links></task>