awTxDeliverErrorReplyEvent
BrokerError awTxDeliverErrorReplyEvent(
BrokerTxClient txclient,
BrokerEvent request_event,
BrokerEvent error_event);
txclient | The Broker client that is transactionally delivering the event. |
request_event | The original request event. Used to determine the client ID of the sender of the original request. |
error_event | The error event to be delivered. |
Sends a single error event to the Broker to be transactionally delivered to the Broker client that published the request_event. This function properly sets the tag, appSeqn, and appLastSeqn envelope fields.
If the trackId envelope field was set on request_event, that value is copied to the error_event event. If the request_event trackId envelope field was not set, the pubId envelope field from the request_eventwill be used instead.
The error_event will be delivered to the Broker client with the client ID contained in the errorsTo envelope field of request_event, if it was set by the requestor.
Note:
An error will not be returned if the recipient, represented by the pubId field in request_event, no longer exists.
Possible BrokerError major codes | Meaning |
AW_ERROR_INVALID_CLIENT | The Broker client, represented by the txclient parameter, has been destroyed or disconnected. |
AW_ERROR_INVALID_EVENT | The request_event or error_event is invalid, the request_event was not received from the Broker, or the error_event does not match its type definition. |
AW_ERROR_NO_PERMISSION | The txclient does not have permission to publish the error_event. |
AW_ERROR_UNKNOWN_EVENT_TYPE | The event type for error_event does not exist on the Broker. |
See also: