Previous

Next

Function xn_telnet_getstring

This function retrieves data from the Telnet server.

int xn_telnet_getstring(tnc_context * context, 
                        char        * buffer, 
                        int           len, 
                        int           timeout);

Parameters

context

Pointer to the Telnet session context structure. The context must have been established by xn_telnet_connect.

buffer

Pointer to a buffer to receive the incoming data.

len

Number of bytes available in *buffer.

timeout

Number of milliseconds to wait if no data is available.

return value

If the function fails, SOCKET_ERROR. Otherwise, it returns the number of bytes received or 0 if the timeout expired with no data received.

At most len-1 bytes are received. xn_telnet_getstring will null-terminate the received data. For interactive Telnet clients, it is recommended to execute xn_telnet_getstring and xn_telnet_sendstring in separate threads.

Telnet Client

Function xn_telnet_sendstring

Function xn_telnet_disconnect