Associate the specified value with the specified data key in any metric belonging to a category having the specified categoryName, or, if categoryName ends with an asterisk (*), any metric belonging to a category whose name begins with categoryName (without the asterisk). Optionally specify a metrics manager to configure. If manager is 0, configure the default metrics manager; if manager is 0 and the default metrics manager has not been initialized, this method has no effect. This association applies to existing metrics as well as any subsequently created ones. When a metric is created that matches more than one registered category prefix, it is not specified which supplied value will be associated with key, unless only one of those values is non-null, in which case the unique non-null value is used. The behavior is undefined unless key was previously created for the indicated metrics manager's metrics registry (e.g., by calling createUserDataKey).
Declared in <balm_configurationutil.h>
static
void
setUserData(
char const* categoryName,
MetricDescription::UserDataKey key,
void const* value,
MetricsManager* manager = 0);