MVI-ADMNET
♦
'C' Programmable
WATTCP API Functions
Ethernet Module
Page 78 of 90
ProSoft Technology, Inc.
December 13, 2006
tcp_listen
Syntax:
int tcp_listen( tcp_Socket *sk, word lPort, longword ina, word port,
dataHandler_t datahandler, word timeout );
Parameters:
sk
Pointer to the socket that has been initialized.
lPort
Local port number.
datahandler
Data Handler. Not used in this version. Use NULL for this parameter.
ina
Host IP Address.
port
Host port number.
timeout
Value used to set the period of time to wait for data. 0 is set to indicate no
timeout.
Description:
This function is used for listening to an incoming message.
port
is an option
parameter. Most of the time, port can be set to 0. The API will find an available
port number for the socket.
ina
is a host IP address passed as a longword.
Function resolve can be used to convert an IP address into a longword-formatted
variable. 0 can be passed as an
ina
value if there is no specific IP Address to
listen too.
Example:
tcp_Socket *socket;
int port = 5656;
. . .
tcp_listen(socket, port, 0L, 0, NULL, 0);
See Also:
ADM_send_socket
