_OPENCONNECTION

From QB64 Wiki
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



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page