Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awGet | awGetTxClientAccessLabel
 
awGetTxClientAccessLabel
BrokerError awGetTxClientAccessLabel(
BrokerTxClient txclient,
int *n,
short **label);
txclient
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 txclient has an owner, but the access label feature is not enabled.
AW_ERROR_BROKER_FAILURE
The txclient has an owner, but an error occurred looking up the access label.
AW_ERROR_INVALID_CLIENT
The txclient has been destroyed or disconnected.
AW_ERROR_NO_PERMISSION
The txclient 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: