awTxDeliverEvents

awTxDeliverEvents

BrokerError awTxDeliverEvents(
BrokerTxClient txclient,
char *dest_id,
int n,
BrokerEvent *events);

txclient	The Broker client that is transactionally sending the events.
dest_id	The identifier of the Broker client to which the events are to be delivered.
n	The number of events in the array.
events	The array of events that are to be delivered.

Deliver multiple events. Gives an array of events to the Broker to have them all delivered to the txclient with the given client ID. Either all of the events or none of them are delivered. n is the number of events in the events array. No error is returned if there is no client using the destination client ID.

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 txclient 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 invalid.
AW_ERROR_NO_PERMISSION	The txclient does not have permission to publish the event type.
AW_ERROR_NULL_PARAM	The parameter dest_id or events is NULL.
AW_ERROR_OUT_OF_RANGE	The parameter n is less than zero.
AW_ERROR_UNKNOWN_EVENT_TYPE	The event type does not exist on the Broker.