_OPENHOST

From QB64 Phoenix Edition Wiki
Revision as of 12:40, 19 April 2022 by SMcNeill (talk | contribs) (Created page with "{{DISPLAYTITLE:_OPENHOST}} The _OPENHOST function opens a Host which listens for new connections and returns a Host status handle. {{PageSyntax}} : {{Parameter|hostHandle}} = _OPENHOST('''"TCP/IP:8080"''') {{PageDescription}} * Creates an Illegal Function Call error if called with a string argument of the wrong syntax. * The port used in the syntax example is 8080. * Valid {{Parameter|hostHandle}} values are negative numbers. * If the syntax i...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The _OPENHOST function opens a Host which listens for new connections and returns a Host status handle.


Syntax

hostHandle = _OPENHOST("TCP/IP:8080")


Description

  • Creates an Illegal Function Call error if called with a string argument of the wrong syntax.
  • The port used in the syntax example is 8080.
  • Valid hostHandle values are negative numbers.
  • If the syntax is correct but they fail to begin/connect a hostHandle of 0 is returned.
  • Always check if the handle returned is 0 (failed) before continuing.
  • CLOSE hostHandle closes the host. A failed handle value of 0 does not need to be closed.


See also



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