awSetTxClientStateShareLimit
BrokerError awSetTxClientStateShareLimit(
BrokerTxClient txclient,
int limit);
txclient | The Broker client whose share limit is to be set. |
limit | The maximum number of clients that may share state with txclient. If set to -1, an unlimited number of clients may share state with txclient. |
Sets the maximum number of Broker clients that can share state with txclient. 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 txclient has been destroyed or disconnected. |
AW_ERROR_NO_PERMISSION | The txclient has an unshared client state. |
AW_ERROR_OUT_OF_RANGE | The parameter limit is zero or less than -1. |
See also: