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.