Events

This section describes the concept of the events in the QoS.

The following list describes the events in the QoS:

• CSubConGenEventDataClientJoined and CSubConGenEventDataClientLeft - The source and destination end points of the data client are presented with this event, along with the IAP ID of the connection on which it is created. These two events are derived from CSubConGenEventDataClientBase and they provide the functionality for both.

• CSubConNotificationEvent - Both generic and extension subconnection events derive from this class. The rules for generic and extension events are the same as for parameter sets. The IsGeneric() method identifies whether the event is generic. The GroupId() method returns the UID of the factory that contains the event, and Id() returns the class type Id within that factory. This information consists of the STypeId of the event.

• CSubConGenEventParamsGranted - Notification of this event occurs when a request to SetParameters() is sent and negotiation with the network is completed. A notification is received for each successful negotiation with the family contained in the parameter bundle. This event represents a generic set and zero or more extension sets of the parameter family identified by the Id returned from GetFamily().

• CSubConGenEventParamsRejected - Notification of this event occurs after a request to SetParameters() is made and negotiation with the network fails. It can be an error within the handset software or configuration, or that the network cannot provide the acceptable, that is the minimum level of QoS. The reason for failure and the parameter family are presented by the accessor methods Error() and FamilyId(). A notification for CSubConGenEventParamsRejected event is received for each family in the parameter bundle that cannot be negotiated successfully.

• CSubConGenEventParamsChanged - This event occurs when the properties of a parameter family are negotiated due to some event on the network. It is not sent in response to a request to change the properties. The change can be the result of an error or just that the level of QoS has improved or worsened. If a new set of parameters are available they are presented as with the CSubConGenEventParamsGranted event. The error status is presented through the Error() method.

• CSubConGenEventSubConDown - This event occurs when the underlying subconnection is lost. This can be due to the request for it to be closed, or some error on the network. The error status is presented through the Error() method.