awNewBrokerFilter

awNewBrokerFilter

BrokerError awNewBrokerFilter(
BrokerClient client,
char *event_type_name,
char *filter_string,
BrokerFilter *filter);

client	The Broker client for which this filter is being created.
event_type_name	The name of the event type to be filtered. A wildcard may be added to the end of the event type name. See Using Wildcards for more information.
filter_string	The filter string.
filter	The newly created filter. This parameter is used for output.

Creates filter, using the specified filter_string. The caller is responsible for calling awDeleteFilter on the return value.

Possible BrokerError major codes	Meaning
AW_ERROR_FILTER_PARSE	An error occurred while attempting to parse filter_string.
AW_ERROR_INVALID_CLIENT	The client has been destroyed or disconnected.
AW_ERROR_NULL_PARAM	The parameter event_type_name is NULL.