awTxDeliverEvent
BrokerError awTxDeliverEvent(
BrokerTxClient txclient,
char *dest_id,
BrokerEvent event);
txclient | The Broker client that is transactionally delivering the event. |
dest_id | Identifies the Broker client to which the event is to be delivered. |
event | The event that is to be delivered. |
Transactionally sends the specified event to the Broker client with the client identifier represented by dest_id. The event is sent to the Broker which, in turn, forwards it to the destination Broker client. The tcclient that is to receive the delivered event is not required to have registered a subscription for the event type, but its client group must allow the Broker client to receive the event type.
A typical use of this function is when your
Broker client replies to a request event from another
Broker client. In such a case, you can obtain the
dest_id by extracting it from the envelope of the request event, as described on
Delivering Events.
Note:
An error will not be returned if the recipient, represented by dest_id, no longer exists.
Possible BrokerError major codes | Meaning |
AW_ERROR_INVALID_CLIENT | The Broker client, represented by the client parameter, has been destroyed or disconnected. |
AW_ERROR_INVALID_CLIENT_ID | The destination client ID contains illegal characters. |
AW_ERROR_INVALID_EVENT | The event is not valid. |
AW_ERROR_NO_PERMISSION | The txclient does not have permission to publish the event type. |
AW_ERROR_NULL_PARAM | The parameter dest_id is NULL. |
AW_ERROR_UNKNOWN_EVENT_TYPE | The event type for the event does not exist on the Broker. |
See also: