<?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 concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-4F02CF5E-7AA6-55AD-B3C5-42892547C188" xml:lang="en"><title>Rejecting

a Newly-Available Bearer</title><shortdesc>This tutorial explains how to set the mobility policy handler component

to reject a newly-available bearer. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section><title>Procedure</title> <ol id="GUID-E5F79F00-7C4E-55B6-90CF-F4AC37E7A3A9">

<li id="GUID-785F664C-B038-51D0-AFEE-ADA310609848"><p>Derive a class from

the <xref href="GUID-D3ED20A6-A16E-368E-98AD-820A469613EE.dita"><apiname>CImMobilityPolicyPlugin</apiname></xref> class. </p> </li>

<li id="GUID-D4F785E4-4837-5937-8247-04A163AF33DA"><p>Implement the <xref href="GUID-65871401-3D98-3B2B-9AA2-C7DB43F9AF57.dita"><apiname>PreferredCarrierAvailable</apiname></xref> and <xref href="GUID-B145C26A-4765-31DA-8514-C4F0659FA71B.dita"><apiname>MigrationComplete</apiname></xref> functions in the derived <xref href="GUID-D3ED20A6-A16E-368E-98AD-820A469613EE.dita"><apiname>CImMobilityPolicyPlugin</apiname></xref> class

to get the required behaviour when a new bearer is available. </p> <p>When

a new bearer is available, the Network bearer mobility framework calls the <xref href="GUID-9A3979A9-F882-3053-B5B1-E0E125774271.dita#GUID-9A3979A9-F882-3053-B5B1-E0E125774271/GUID-E4D234C3-AEEA-3FE9-8E5D-6914BB60B174"><apiname>MMobilityProtocolResp::PreferredCarrierAvailable</apiname></xref> function

to notify the bearer mobility policy manager. This happens only if the bearer

mobility policy manager is registered with the <xref href="GUID-65871401-3D98-3B2B-9AA2-C7DB43F9AF57.dita"><apiname>PreferredCarrierAvailable</apiname></xref> (Network

bearer mobility framework) for bearer mobility notification. </p> </li>

<li id="GUID-A5838C52-C82C-5D36-9E77-485B2F2734C5"><p>To reject the newly

available bearer should be rejected, call the<xref href="GUID-93466135-4C80-30B2-85C4-A045A7D34C6E.dita#GUID-93466135-4C80-30B2-85C4-A045A7D34C6E/GUID-45248469-5730-3D67-8D47-CE88A9F04F96"><apiname>CImMobilityManager::IgnoreNewCarrier()</apiname></xref> function

on the instance of <xref href="GUID-93466135-4C80-30B2-85C4-A045A7D34C6E.dita"><apiname>CImMobilityManager</apiname></xref> identified in the <xref href="GUID-4D26288F-A8F8-355E-B49C-B313EEC04584.dita"><apiname>PreferredCarrierAvailable()</apiname></xref> function. </p> </li>

</ol> </section>

</conbody><related-links>

<link href="GUID-24860917-0FE2-5C8F-B436-96928350996E.dita"><linktext>Bearer Mobility

                Overview</linktext></link>

<link href="GUID-93221B70-EB36-5E8E-AE23-700988D5DACB.dita"><linktext>Bearer Mobility

Policy Plug-in                 Overview</linktext></link>

</related-links></concept>