Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awTx | 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.