URL_Stop (changes)
Showing changes from revision #1 to #2:
Added | Removed | Changed
URL_Fetcher
» SWI Calls
» URL_Stop
URL_Stop
(SWI &83E05)
Abort a request placed with the URL module.
| Entry | ||
|---|---|---|
| R0 | Flags: | |
| Bits 31..0 | Reserved (0) | |
| R1 | Session identifier | |
| Exit | |
|---|---|
| R0 | Status word (see |
| All other registers preserved | |
| SWI is not re-entrant | |
| Interrupt status undefined | |
Use
This call aborts a current request if there is one associated with the session identifier. In the event of no request being associated with the identifier, an error is generated. The purpose of this SWI call is to provide the client with a way of enforcing the termination of a request. It is not called by the client just because all the data associated with the request has finished being transferred, although it may do that if it so chooses. The URL_Stop call will be made automatically by the URL module when the session is deregistered by the client using SWI URL_Deregister.URL_Deregister.
When this SWI is called, the URL module invokes the Protocol_StopProtocol_Stop SWI for the protocol module concerned with the request.
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.