CONNECTED: Difference between revisions
Jump to navigation
Jump to search
Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
No edit summary Tag: Manual revert |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:_CONNECTED}} | {{DISPLAYTITLE:_CONNECTED}} | ||
The [[_CONNECTED]] function returns the status of a TCP/IP connection handle. | The [[_CONNECTED]] function returns the status of a TCP/IP or HTTP connection handle. | ||
| Line 8: | Line 8: | ||
{{PageDescription}} | {{PageDescription}} | ||
* The handle can come from the [[_OPENHOST]], [[OPENCLIENT]] or [[_OPENCONNECTION]] | * The handle can come from the [[_OPENHOST]], [[OPENCLIENT]] or [[_OPENCONNECTION]]. | ||
* Returns -1 if still connected or 0 if connection has ended/failed. | * Returns -1 if still connected or 0 if connection has ended/failed. | ||
* Do not rely solely on this function to check for ending communication. | * Do not rely solely on this function to check for ending communication. | ||
* Use "time-out" checking as well and [[CLOSE]] any suspect connections. | * Use "time-out" checking as well and [[CLOSE]] any suspect connections. | ||
Revision as of 07:45, 6 January 2023
The _CONNECTED function returns the status of a TCP/IP or HTTP connection handle.
Syntax
- result& = _CONNECTED(connectionHandle&)
Description
- The handle can come from the _OPENHOST, OPENCLIENT or _OPENCONNECTION.
- Returns -1 if still connected or 0 if connection has ended/failed.
- Do not rely solely on this function to check for ending communication.
- Use "time-out" checking as well and CLOSE any suspect connections.
- If this function indicates the handle is not connected, any unread messages can still be read using GET #.
- Even if this function indicates the handle is not connected, it is important to CLOSE the connection anyway or important resources cannot be reallocated.
See also