DoneEx INI-File Manager Library  API Help

  SetKeyValue

Sets new value of key by its index inside indicated section into memory structure.

				
int SetKeyValue(const long ini_file_num,
                const long section_index, 
                const long key_index, 
                const char* new_key_value
);				

Parameters
ini_file_num
[input] INI-file number which points to the data in memory structure. This number has to be saved from the return value of the previous call CreateINI or LoadINI functions.
section_index
[input] The zero-based index of the section that is enumerated from begin of INI-file.
key_index
[input] Long value that specifies the key index.
new_key_value
[input] Pointer to a null-terminated string that specifies the new key value.

Return Values
If succeed the SetKeyValue function returns zero. Otherwise it returns value not equal to zero. To get extended error information, call GetLastErr.

Remark
Here is description of special features and way to use.