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 Exception listeners in C++.