Writes any outstanding updates to a configuration file.
If the data in RAM has not changed then no write will occur. Turns the dirty flag off.
* Also adds standard P6 entries to the first (unnamed) section, for example:
*
* P6R-DATE = 2004-08-14 16:00:26 (101580) GMT
* P6R-ENCODING = en_US
* P6R-VERSION = 1.0
*
- Parameters
-
pAlternateName | [ in ] Can be NULL, if set then flush to this file INSTEAD OF the file specified in createConfigFile or openConfigFile. |
withDefaults | [ in ] See getConfigInt for a description of default values. If this parameter is set to true, then all default values automatically added to the in RAM image of the configuration are written out to the configuration file. Otherwise they are ignored. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eAccessFault | If readOnly was true on initialize call. |
P6R::eIoError | If pPathName or pAlternateName could not be openned for write. | |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |