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-EB0D6244-0975-53DA-8F11-7B59A2D851AF" xml:lang="en"><title>Events</title><shortdesc>This section describes the concept of the events in the QoS. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    13 <p>The following list describes the events in the QoS: </p>

    14 <ul>

    15 <li id="GUID-CDB99D89-E8A7-5FAA-87EB-B410DC8C2B7F"><p> <b>CSubConGenEventDataClientJoined</b> and <b>CSubConGenEventDataClientLeft</b> -

    16 The source and destination end points of the data client are presented with

    17 this event, along with the IAP ID of the connection on which it is created.

    18 These two events are derived from <codeph>CSubConGenEventDataClientBase</codeph> and

    19 they provide the functionality for both. </p> </li>

    20 <li id="GUID-2355941B-69C5-5604-AF9D-141753DB27C6"><p> <b>CSubConNotificationEvent</b> -

    21 Both generic and extension subconnection events derive from this class. The

    22 rules for generic and extension events are the same as for parameter sets.

    23 The <codeph>IsGeneric()</codeph> method identifies whether the event is generic.

    24 The <codeph>GroupId()</codeph> method returns the UID of the factory that

    25 contains the event, and <codeph>Id()</codeph> returns the class type Id within

    26 that factory. This information consists of the <codeph>STypeId</codeph> of

    27 the event. </p> </li>

    28 <li id="GUID-D5216E71-7DE4-5053-86E6-EF9DDEDE4940"><p> <b> CSubConGenEventParamsGranted</b> -

    29 Notification of this event occurs when a request to <codeph>SetParameters()</codeph> is

    30 sent and negotiation with the network is completed. A notification is received

    31 for each successful negotiation with the family contained in the parameter

    32 bundle. This event represents a generic set and zero or more extension sets

    33 of the parameter family identified by the Id returned from <codeph>GetFamily()</codeph>. </p> </li>

    34 <li id="GUID-3CE9943D-2E68-54F4-9CA7-E9843B8E7CB4"><p> <b>CSubConGenEventParamsRejected</b> -

    35 Notification of this event occurs after a request to <codeph>SetParameters()</codeph> is

    36 made and negotiation with the network fails. It can be an error within the

    37 handset software or configuration, or that the network cannot provide the

    38 acceptable, that is the minimum level of QoS. The reason for failure and the

    39 parameter family are presented by the accessor methods <codeph>Error()</codeph> and <codeph>FamilyId()</codeph>.

    40 A notification for <xref href="GUID-7103CFA3-2119-3356-9460-B26D88036FEB.dita"><apiname>CSubConGenEventParamsRejected</apiname></xref> event

    41 is received for each family in the parameter bundle that cannot be negotiated

    42 successfully. </p> </li>

    43 <li id="GUID-D7611427-9B1F-5687-A10B-F80AC47B71CA"><p> <b>CSubConGenEventParamsChanged</b> -

    44 This event occurs when the properties of a parameter family are negotiated

    45 due to some event on the network. It is not sent in response to a request

    46 to change the properties. The change can be the result of an error or just

    47 that the level of QoS has improved or worsened. If a new set of parameters

    48 are available they are presented as with the <xref href="GUID-AA6CFA1E-0B17-3603-9065-34D05322C0A5.dita"><apiname>CSubConGenEventParamsGranted</apiname></xref> event.

    49 The error status is presented through the <codeph>Error()</codeph> method. </p> </li>

    50 <li id="GUID-CD6E64F1-4F70-59ED-B0A5-7E5FE1B0BB19"><p> <b>CSubConGenEventSubConDown</b> -

    51 This event occurs when the underlying subconnection is lost. This can be due

    52 to the request for it to be closed, or some error on the network. The error

    53 status is presented through the <codeph>Error()</codeph> method. </p> </li>

    54 </ul>

    55 </conbody></concept>