Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awNew | awNewSubscriptionsFromStructs
 
awNewSubscriptionsFromStructs
BrokerError awNewSubscriptionsFromStructs(
BrokerClient client,
int n,
BrokerSubscription *subs);
client
The Broker client requesting the subscriptions.
n
The number of subscription structures in the array.
subs
An array of subscription structures. See BrokerSubscription Objects for more information.
Subscribes the specified client to the events specified by the subscription structures in the array subs. Each of the subscription structures should be initialized with the desired subscription identifier, event name, and filter string.
If one or more of the subscriptions in subs has already been registered, calling this function will have no effect on those subscriptions. A subscription with a sub_id of 1 will not be replaced with a new subscription with a sub_id of 2 that otherwise is identical.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The client has been destroyed or disconnected.
AW_ERROR_INVALID_SUBSCRIPTION
One of the subs filter strings contains a parse error.
AW_ERROR_NO_PERMISSION
The client does not have permission to subscribe to one of the subs event types.
AW_ERROR_NULL_PARAM
The parameter sub, or one of the subscriptions it contains, is NULL.
AW_ERROR_OUT_OF_RANGE
The sub_id parameter or one of the subscriptions is less than zero.
AW_ERROR_UNKNOWN_EVENT_TYPE
The event type of one of the subscriptions does not exist on the Broker.
See also: