@CHIP-RTOS C Library V2.06 - BIOS API
BIOS_Set_Ini_String
Insert an entry into CHIP.INI. int BIOS_Set_Ini_String ( const char far *section,
const char far *item_name,
const char far *item_text ); Parameters
section
- Pointer to section string (max. 40 chars)
item_name
- Pointer to item name (max. 40 chars)
item_text
- Pointer to item text (max. 128 chars)
Pass a NULL pointer here to erase the complete item line
Return Value
- 0: success
-1: Invalid string length, low heap memory or file error.
Comments
- This API is thread safe and reentrant. This function will
fail (no operation) if insufficient system heap memory is
available to momentarily hold the contents of the CHIP.INI file.
Example usage:
| BIOS_Set_Ini_String ("MY_SECTION", "MY_ITEM", "VALUE_TEXT") ;
... produces the following CHIP.INI entry
[MY_SECTION]
MY_ITEM=VALUE_TEXT |
See Also
RTOS API
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
documentation
for more details.
Supported since or modified in @CHIP-RTOS version-
SC12 | SC13 | SC11 | SC1x3 |
-
V1.20 | V1.20 | V1.20 | V1.05 |
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document
|