If a section name does not exist, then that section is created and the new key-name=value pair is written.
Creates a new or updates an existing "name=value" pair in a section of an ".ini" file. If pSectionName is NULL then the unnamed section is used.
- Parameters
-
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" |
value | [ in ] integer with the value of the key. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | If pKeyName is NULL or contains a reserved character. |
P6R::eFormatError | If length of pSectionName + pKeyName is > P6R::MAX_IDENTIFER_SIZE |
P6R::eNoMemory | Insufficient memory to make a copy of the "value" parameter. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |