1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

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

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

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

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

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

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

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

    18 <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

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

    20 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

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

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

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

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

    25 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

    26 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>

    27 </ol> </section>

    28 </conbody><related-links>

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

    30                 Overview</linktext></link>

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

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

    33 </related-links></concept>