Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awDeliver | awDeliverRequestAndWait
BrokerError awDeliverRequestAndWait(
BrokerClient client,
char *dest_id,
BrokerEvent event,
int msecs,
int *n,
BrokerEvent **reply_events);
The Broker client that is sending the event.
The identifier of the Broker client to which the event is to be delivered.
The request event to be delivered.
The number of milliseconds to block awaiting a reply. If set to AW_INFINITE, this function will block indefinitely.
The number of reply events returned in the events array. This parameter is used for output.
The array of reply events that are returned. This parameter is used for output.
Sends the event to the Broker to be delivered to the Broker client specified by dest_id and then waits for all replies to be received. The last reply event is detected when an event is received with the envelope fields appSeqn and appLastSeqn being equal.
This function creates a value for the tag envelope field using the awMakeTag function. This function blocks until the replies are received or until the requested time-out interval expires.
You are responsible for deleting each event returned in reply_events, using the awDeleteEvent function, and for freeing the array itself, using free.
See Using Request-Reply for more information on using the request-reply model.
You must register a general callback object, using the awRegisterCallback function, before calling this function. Also note that an error will not be returned if the recipient, represented by dest_id, no longer exists.
Possible BrokerError major codes
This function was called from a callback function.
The Broker client, represented by the client parameter, has been destroyed or disconnected.
The event is invalid or does not match its type definition.
The client does not have permission to publish the event type.
The parameter dest_id, n, or reply_events is NULL.
The event type for event does not exist on the Broker.
See also: