Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awSet | awSetClientStateShareLimit
 
awSetClientStateShareLimit
BrokerError awSetClientStateShareLimit(
BrokerClient client,
int limit);
client
The Broker client whose share limit is to be set.
limit
The maximum number of clients that may share state with client. If set to -1, an unlimited number of clients may share state with client.
Sets the maximum number of Broker clients that can share state with client. A client's state consists of its event queue and its event subscriptions. If limit is less than the current number of clients sharing the state, all of the Broker clients are allowed to remain connected. However, no new clients will be allowed to share the client state until the number of clients drops below limit.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The client has been destroyed or disconnected.
AW_ERROR_NO_PERMISSION
The client has an unshared client state.
AW_ERROR_OUT_OF_RANGE
The parameter limit is zero or less than -1.
See also: