awTxPublishEvents

awTxPublishEvents

BrokerError awTxPublishEvent(
BrokerTxClient txclient,
int n,
BrokerEvent *event);

txclient	The Broker client to transactionally publish the event.
n	The number of events in the array.
event	The event to be published.

Transactionally publishes multiple events. Gives an array of events to the to have them all delivered to the client 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.

Note:
This function can fail if the Broker client does not have permission to publish the event type, based on its client group, or if the event is not properly formed. See awTxCanPublish for more information.

Possible BrokerError major codes	Meaning
AW_ERROR_INVALID_CLIENT	The txclient is not valid.
AW_ERROR_INVALID_EVENT	The event is not valid or the event does not match its type definition.
AW_ERROR_NO_PERMISSION	The txclient does not have permission to publish all of the event type.
AW_ERROR_NULL_PARAM	The parameter 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.