HTTP_ConsumeCookie
AcornHTTP
» SWI Calls
» HTTP_ConsumeCookie
HTTP_ConsumeCookie
(SWI &83FBE)
| Entry | |||
|---|---|---|---|
| R0 | Flags | ||
| Bit 0 => | Set for accept, unset for reject | ||
| Bits 1-31 => | Reserved. Must be zero | ||
| R1 | Session? Unused? | ||
| R2 | The handle of a queued cookie as returned by HTTP_EnumerateCookies | ||
| Exit | |
|---|---|
| - | No exit defined |
Use
Unless Browse$AcceptAllCookies is set to a value which is not “off”, any cookies found in the headers of responses received by AcornHTTP will be added to a temporary queue to be processed.
For each cookie in the queue, the client is expected to indicate whether the cookie should be accepted or rejected. If the cookie is accepted it will be moved to the cookie store. Either way, the cookie will be removed from the queue.
Notes
Because the cookie has been removed from the queue, it is not possible to resume enumeration of the queue by passing the same cookie handle in R1 on entry to HTTP_EnumerateCookies.
If a client wishes to process the entire queue of cookies, it is therefore simplest to alternate calls to HTTP_EnumerateCookies and HTTP_ConsumeCookie, passing R1=0 on entry to HTTP_EnumerateCookies every time.
The module does not have support for the Public Suffix List
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.