www.beck-ipc.com

@CHIP-RTOS C Library V2.00 - 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)

Return Value

0:  success
-1:  Invalid string length

Comments

Important :
    The API functions BIOS_Set_Ini_String and BIOS_Get_Ini_String are not reentrant.  Do not use these in different tasks or in combination with @CHIP-RTOS commands which write to CHIP.INI e.g. DHCP.   Avoid race conditions with any other API calls which read or write the CHIP.INI file.

Example:

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.


This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document