OPENCONNECTION: Difference between revisions
Jump to navigation
Jump to search
Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
No edit summary Tag: Manual revert |
No edit summary |
||
| Line 7: | Line 7: | ||
{{PageDescription}} | {{PageDescription}} | ||
* Valid {{Parameter|connectHandle}} values returned are negative numbers. | * Valid {{Parameter|connectHandle}} values returned are negative numbers. | ||
* If the syntax is correct but they fail to begin/connect, a {{Parameter|connectHandle}} of 0 is returned. | * If the syntax is correct but they fail to begin/connect, a {{Parameter|connectHandle}} of 0 is returned. | ||
* Always check if the handle returned is 0 (failed) before continuing. | * Always check if the handle returned is 0 (failed) before continuing. | ||
* [[CLOSE]] #{{Parameter|connectHandle}} closes the connection. Failed connections({{Parameter|connectHandle}} = 0) do not need to be closed. | * [[CLOSE]] #{{Parameter|connectHandle}} closes the connection. Failed connections({{Parameter|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. | * As a '''Host''' you can check for new clients (users). Each will have a unique connection handle. | ||
Latest revision as of 02:14, 23 January 2023
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