int ausearch_next_event(auparse_state_t *au);
ausearch_next_event will scan the input source and evaluate whether any record in an event contains the data being searched for. Evaluation is done at the record level.
Returns -1 if an error occurs, 0 if no matches, and 1 for success.
ausearch_add_item(3), ausearch_add_regex(3), ausearch_set_stop(3).