_OPENCONNECTION
Jump to navigation
Jump to search
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