OPENCONNECTION

The _OPENCONNECTION function opens a connection from a client that the host has detected and returns a status handle.

Syntax

connectHandle = _OPENCONNECTION(hostHandle)

Description

• Valid connectHandle values returned are negative numbers.
• If the syntax is correct but they fail to begin/connect, a connectHandle of 0 is returned.
• Always check if the handle returned is 0 (failed) before continuing.
• CLOSE #connectHandle closes the connection. Failed connections(connectHandle = 0) do not need to be closed.
• As a Host you can check for new clients (users). Each will have a unique connection handle.
• Creates an Illegal Function Call error if called with a string argument of the wrong syntax.
• Handle values can be used as the open number by GET # read statement and PUT # write statement.

See also

• _OPENHOST, _OPENCLIENT
• _CONNECTED, _CONNECTIONADDRESS

---

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