Function sc_tdc_overrides_add_entry

Function Documentation

int sc_tdc_overrides_add_entry(int handle, const char *section, const char *key, const char *value)

Add an entry to an “override registry” representing a single configuration parameter whose value shall be modified. The entry consists of (1) a section and (2) a key, which correspond to those appearing in ini files, and (3) a value in string form, which will be used instead of the value in the original configuration.

Parameters

  • handle – the non-negative handle returned from sc_tdc_overrides_create()

  • section – the name of the section without the square brackets ([])

  • key – the name of the parameter

  • value – the overriding value in any of the string representations that would also work in ini files. However, do not use quotation marks to enclose actual string-typed parameter values.

Returns

0 on success; negative error code if the handle is unknown; the function does not check whether section, key, or value are valid.