Load the threshold levels that would apply to a new category.

Synopsis

Declared in <ball_loggermanager.h>

int
thresholdLevelsForNewCategory(
    ThresholdAggregate* levels,
    char const* categoryName) const;

Description

Load into the specified *levels the threshold levels that would be set for a newly created category, irrespective of whether a category with the specified categoryName is already in the registry. Return 0 on success and a non‐zero value otherwise. If the client has configured a default threshold levels callback (see ball::LoggerManager::DefaultThresholdLevelsCallback in the component doc), the categoryName will be supplied to that callback which will set *levels. Otherwise, if no default threshold levels callback has been provided, the default threshold levels are used. Note that this function will report an error if the callback returns invalid levels. Also note that if a category named categoryName is already in the registry, the levels returned by this method may differ from the levels of that category.

Return Value

0 on success, and a non‐zero value otherwise

Parameters

Name

Description

levels

destination for the threshold levels that would apply

categoryName

category name used to determine the thresholds

Created with MrDocs