_CONNECTED

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

• _OPENCONNECTION, _CONNECTIONADDRESS$
• _OPENHOST, _OPENCLIENT
• Downloading Files

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link