|
pure virtual |
If the section name does not exist then the unnamed section is used as a default.
Returns the integer"value" from an existing "name=value" pair in the selected section of a configuration file.
If the value identified by pKeyName does not exist in the section then the defaultValue is returned, and that default value is automatically inserted into the section. In order to save an automatically inserted value to the configuration file on disk make sure that the flushConfigFile has the "withDefaults" flag set to true.
The purpose of adding default values to the RAM image of the configuration file is that it is always possible to determine the actual configuration values in use via an enumerator or a call go getConfigSection.
pSectionName | [ in ] Pointer to string defining the section to write the keyName=value pair |
pKeyName | [ in ] Pointer to string defining the name part of: "name=value" |
defaultValue | [ in ] Pointer to integer value to return if key does not exist, set to NULL if no default desired. |
pValue | [ out ] Pointer to integer with the value of the key. |
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | If pKeyName (or pValue) is NULL or contains a reserved character. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. | |
P6R::eFormatError | If length of pSectionName + pKeyName is > P6R::MAX_IDENTIFER_SIZE | |
P6R::eNoMemory | Insufficient memory to look up value. |