An application uses an exception listener to be notified asynchronously of a problem with a connection.
If an application uses a connection only to consume messages asynchronously, and for no other purpose, then the only way the application can learn about a problem with the connection is by using an exception listener. In other situations, an exception listener can provide a more immediate way of learning about a problem with a connection than waiting until the next synchronous call to XMS.
Method | Description |
---|---|
onException | Notify the application of a problem with a connection. |
virtual xmsVOID onException(Exception *exception);
Notify the application of a problem with a connection.
onException() is a method of the exception listener that is registered with the connection. The name of the method must be onException.
For more information about using exception listeners, see Using exception listeners in C++.