Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awRegister | awRegisterCallback
 
awRegisterCallback
BrokerError awRegisterCallback(
BrokerClient client,
BrokerCallback func,
void *client_data);
client
The Broker client for which the callback is being registered.
func
The callback function to be called to handle the event. See Defining a Callback Function.
client_data
A pointer to used-defined data that will passed to the callback function when it is invoked.
Registers a non-specific callback func to process any events received by client. If this function has already been called, the previous callback registration will be replaced with the new registration.
When an event is received for client, the callback function func will be invoked to process the event and will be passed client_data as a parameter. The content and use of client_data is determined by you the caller; it is not examined or used in any way by the Broker system.
Callbacks registered with this function are called non-specific callbacks because they may be invoked to handle any event. You may also use the awRegisterCallbackForSubId function, described on awRegisterCallbackForSubId, to register a specific callback function for a particular event subscription ID. Specific callback functions will take precedence over a non-specific callback function.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The client has been destroyed or disconnected.
AW_ERROR_NULL_PARAM
The func is NULL.
See also: