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.