Previous

Next

Function net_connect

Establishes a connection to a remote host.

int net_connect(SOCKET socket, BYTE * ip_addr, WORD port, int Seconds);

Parameters

socket

Socket returned by net_socket or socket.

ip_addr

Pointer to the IP address to connect to in network byte order.

port

Port number in little endian byte order to connect to.

Seconds

Timeout in seconds. This parameter is ignored if zero, which means the operation waits indefinitely for sockets in blocking mode or returns immediately for sockets in non-blocking mode. Value RTIP_INF will wait indefinitely.

return value

Returns 0 if successful, otherwise SOCKET_ERROR. If an error occurred, call xn_getlasterror and xn_geterror_string to return the error value. Section Error Codes further describes each error.

This function calls function connect internally. For secure sockets, an encryption context is allocated and initialized, the server's certificate is downloaded, and the encryption method is negociated.

Function net_bind

Function net_listen