| Net.WaitForConnection | Part of Net module |
| Syntax | Net.WaitForConnection (port : int, var netAddr : string) : int
|
| Description | Listens for a connection at the port specified by the port parameter. When another program connects to the port, then the function returns. The address of the connecting machine is specified in the netAddr parameter and the Net.WaitForConnection returns a network stream descriptor which can be used with the put, get, read, and write statements and eof function to send and receive data to the connecting program. It is also the parameter used for the Net.CloseConnection, Net.BytesAvailable, Net.CharAvailable, Net.LineAvailable, and Net.TokenAvailable functions. In OOT, the connection to a port is made with the Net.OpenConnection function. The netAddr parameter is a string specifying the net address of the machine that connected to the port. It is the machines numerical address. In general, system program listen in on ports with numbers below 1024. Port numbers above 1024 are generally available for use by user created programs. The program will wait for indefinitely for a connection to made to the port.
|
| Details | The Net module requires a TCP/IP stack to be installed and operating in order to function. It does not communicate using any other protocols It is possible for Firewalls to interfere with the actions of the Net module, preventing connections from taking place.
|
| Example | See Net.OpenConnection for an example of Net.WaitForConnection.
|
| Status | Exported qualified. This means that you can only call the function by calling Net.WaitForConnection, not by calling WaitForConnection.
|
| See also | Net.OpenConnection and Net.CloseConnection.
|