<?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-926862C4-5E13-5896-B959-0D408C748AB5" xml:lang="en"><title>Cancelling

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

<context id="GUID-F5592527-7253-5D09-BED7-706999064AB9"><p>A feature is any

item of functionality which can be included in a phone build or excluded from

it. To cancel 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/><table id="GUID-B820DFE9-17BF-42F0-B7BA-1D1F645A68CD">

<tgroup cols="2"><colspec colname="col1" colwidth="0.31*"/><colspec colname="col2" colwidth="1.69*"/>

<tbody>

<row>

<entry><p><b>Step</b></p></entry>

<entry><p><b>Action</b></p></entry>

</row>

<row>

<entry><p>1</p></entry>

<entry><p>Determine the Uid of the feature for which you want to cancel notification,</p></entry>

</row>

<row>

<entry><p>2</p></entry>

<entry><p>create an instance of your implementation of <xref href="GUID-623C4183-00F0-36B0-AE1F-5C5EDCAF1B3D.dita"><apiname>MFeatureObserver</apiname></xref>,</p></entry>

</row>

<row>

<entry><p>3</p></entry>

<entry><p>construct an instance of <xref href="GUID-CA12C6F7-E997-33B8-9463-B326BC1832C5.dita"><apiname>CFeatureNotifier</apiname></xref> with

an instance of your observer as argument of the constructor function,</p></entry>

</row>

<row>

<entry><p>4</p></entry>

<entry><p>call its <xref href="GUID-1BD7F2E7-9EAB-3EB7-8520-77B87796DC14.dita"><apiname>NotifyCancel()</apiname></xref> function with the Uid

of the feature as argument, and</p></entry>

</row>

<row>

<entry><p>5</p></entry>

<entry><p>destroy the <xref href="GUID-CA12C6F7-E997-33B8-9463-B326BC1832C5.dita"><apiname>CFeatureNotifier</apiname></xref> object. </p></entry>

</row>

</tbody>

</tgroup>

</table> <p/><p>To cancel all feature notification requests, follow the

same procedure but instead of <xref href="GUID-1BD7F2E7-9EAB-3EB7-8520-77B87796DC14.dita"><apiname>NotifyCancel()</apiname></xref> call <xref href="GUID-5B8D617C-9F9B-3260-82BD-68CF43C4697E.dita"><apiname>NotifyCancelAll(</apiname></xref> )

with no arguments.  </p><p><xref href="GUID-1BD7F2E7-9EAB-3EB7-8520-77B87796DC14.dita"><apiname>NotifyCancel()</apiname></xref> returns:  </p><table id="GUID-3A2A3538-FF86-436F-A8C6-6692017645AA">

<tgroup cols="2"><colspec colname="col1" colwidth="0.31*"/><colspec colname="col2" colwidth="1.69*"/>

<tbody>

<row>

<entry><p><b>Step</b></p></entry>

<entry><p><b>Action</b></p></entry>

</row>

<row>

<entry><p>6</p></entry>

<entry><p><xref href="GUID-5E653C17-372C-32E1-A1B2-9E69A9991C40.dita"><apiname>KErrNotFound</apiname></xref> if the feature does not exist, and </p></entry>

</row>

<row>

<entry><p>7</p></entry>

<entry><p>otherwise returns a Symbian platform error code. </p></entry>

</row>

</tbody>

</tgroup>

</table><p><xref href="GUID-D4C50C10-4233-31D5-85F8-90126263F310.dita"><apiname>NotifyCancelAll()</apiname></xref> returns one of the Symbian

platform error codes. </p></context>

</taskbody><related-links>

<link href="GUID-ADC42872-9A5B-50F2-8A33-6621A8F7C177.dita"><linktext>Handling

feature                 notification</linktext></link>

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

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>