awGetScopeNames
BrokerError awGetScopeNames(
BrokerClient client,
int *n,
char ***scope_names);
client | The Broker client requesting the scope names. |
n | The number of strings in scope_names. This parameter is used for output. |
scope_names | An array of strings containing the event scope names. This parameter is used for output. |
Provides the event type scope names for the specified client's Broker.
Note:
Only the scope names of the event types which your client is permitted to browse are returned. In most cases, this corresponds to the scope names that contain event types which your client can publish or for which it can register subscriptions.
The caller is responsible for calling free on scope_names. The strings in scope_names share one memory block so multiple calls to free are not necessary.
Possible BrokerError major codes | Meaning |
AW_ERROR_INVALID_CLIENT | The client has been destroyed or disconnected. |
AW_ERROR_NULL_PARAM | The parameter n or scope_names is NULL. |
See also: