Set threshold levels for all categories matching a name prefix.
Declared in <ball_categorymanager.h>
int
setThresholdLevelsHierarchically(
char const* categoryNamePrefix,
int recordLevel,
int passLevel,
int triggerLevel,
int triggerAllLevel);Set the threshold levels of all existing and future categories whose name starts with the specified categoryNamePrefix unless it is empty, possibly changed by the registered category name filter callback, to the specified recordLevel, passLevel, triggerLevel, and triggerAllLevel if those levels form valid settings and return the number of categories updated (zero or a positive number). In case categoryNamePrefix is empty update all categories with the threshold levels and delete all stored orphan hierarchical settings. In other words an empty category setting will never overwrite the defaults for future hierarchical categories. The behavior is undefined unless a lock is not held by this thread on the mutex returned by rulesetMutex. If any of the specified threshold levels is invalid, return a negative value.
number of categories updated, or a negative value on error
| Name | Description |
|---|---|
| categoryNamePrefix | name prefix of categories to update |
| recordLevel | record threshold level to set |
| passLevel | pass threshold level to set |
| triggerLevel | trigger threshold level to set |
| triggerAllLevel | trigger-all threshold level to set |