IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

Comments
DX=0 AX=0 , ES:DI contains pointer to current main page name
The string referenced by [ES:DI] is null terminated and is in the RTOS's data space.
Related Topics
Top of list
Index page
CGI_SETMAIN API Function
Interrupt 0xAB service 0x07: CGI_GETFORMITEM, Split a formular into name and value
Parameters
AH
BX:SI
ES:DI
Parse the argument buffer to obtain name and value.
0x07 (= CGI_GETFORMITEM)
Pointer to argument buffer to be parsed.
Pointer to a FormItem type structure
Return Value
Comments
DX=0 AX=0, User buffers referenced by pointers in FormItem structure at [ES:DI] are filled in with name
and value
On initial call, the argument buffer pointer provided by the caller in BX:SI is a copy of the
fArgumentBufferPtr member of the rbCgi structure passed by the Web server to the CGI callback
function. On subsequent calls here to pick up additional formular, the pointer returned from the
CGI_FINDNEXTITEM API call can be used here.
The caller must set the two members of the FormItem structure prior to calling here. Both pointers
reference buffers allocated by the user, which will receive strings produced by this API call.
For preventing internal buffer overruns, the user should provide 64 bytes of buffer addressed by
FormItem.NamePtr and 256 bytes pointed by FormItem.ValuePtr. The max. size for a full
pathname (pagename+complete argumentbuffer)
e.g. "example?Name1=Value1&Name2=Value2"
is 256 bytes. Because of this behaviour, the storage addressed by FormItem.ValuePtr must have the
max. size of a full pathname (256 bytes).
See example submit.c.
Related Topics
Page 362 / 400