Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awGet | awGetClientAccessLabel
 
awGetClientAccessLabel
BrokerError awGetClientAccessLabel(
BrokerClient client,
int *n,
short **label);
client
The Broker client whose list of event types is to be returned.
n
The number of element returned in the label array. This parameter is used for output.
label
The access label for the client. This parameter is used for output.
Obtains the access label for the specified client. This label will be inserted in the publabel envelope field of every event the client publishes or delivers.
Access labels provide access control for event types which is independent of the event type.
Possible BrokerError major codes
Meaning
AW_ERROR_BAD_STATE
The client has an owner, but the access label feature is not enabled.
AW_ERROR_BROKER_FAILURE
The client has an owner, but an error occurred looking up the access label.
AW_ERROR_INVALID_CLIENT
The client has been destroyed or disconnected.
AW_ERROR_NO_PERMISSION
The client does not have an owner so it cannot have an access label.
AW_ERROR_NULL_PARAM
The parameter n or label is NULL.
See also: