Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsMulticastExceptionCallback
> Function Type
> Purpose
> Programs define functions of this type to asynchronously detect conditions with EMS multicast that may affect message consumers.
> C Declaration
> typedef void (*tibemsMulticastExceptionCallback) (
> tibemsConnection connection,
> tibemsSession session,
> tibemsMsgConsumer consumer,
> tibems_status status,
> const char* description,
> void* closure);
> Parameters

> Parameter | Description
> connection | This parameter receives the connection object.
> session | This parameter receives the session object.
> consumer | This parameter receives the consumer object.
> status | This parameter receives a status code, which identifies the multicast problem.
> description | This parameter receives a text description describing the multicast problem.
> closure | This parameter receives the closure data, which the program supplied in the call that registered the callback.

> Remarks
> When a program uses a multicast consumer to receive messages, EMS can detect conditions that may indicate a problem, and notify the client program by returning an error status code. The client application can then take the appropriate action.
> This callback provides a pathway for alerting a client program of multicast problems. The program implements this callback and registers it. When the client library detects a multicast problem, it calls this callback and passes it the appropriate EMS objects, a status code that identifies the problem, and a detailed description of the problem. This callback is invoked for each consumer that is affected by the multicast warning or error. Some applications may just simply log the problem; others may take further measures.
> See Also
> tibems_SetMulticastExceptionListener on page 403
> Chapter 13, Using Multicast, in the TIBCO Enterprise Message Service User’s Guide

Copyright © TIBCO Software Inc. All Rights Reserved