TipcSrvSetSocket

Name

TipcSrvSetSocket — set the socket of the connection to RTserver

Synopsis

T_BOOL TipcSrvSetSocket(socket) 
T_INT4 socket; 

Arguments

socket — connection socket

Return Values

TRUE if socket was successfully set for the connection to RTserver, FALSE otherwise.

Diagnostics

If TipcSrvSetSocket fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcSrvSetSocket sets the socket file descriptor of the connection to RTserver by calling TipcConnSetSocket. All data sent to and received from the connection is transmitted on this socket. See TipcSrvGetSocket for more information on connection sockets.

TipcSrvSetSocket may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvSetSocket does not use the warm connection, because the warm connection does not have a valid socket. See TipcSrvCreate on automatic creation of connections and warm connections to RTserver.

Caution

None

See Also

TipcConnSetSocket, TipcSrvGetSocket

Examples

This example sets the socket of the connection to RTserver:

my_socket = my_create_override_socket(); 
 
if (!TipcSrvSetSocket(my_socket)) { 
  return;  /* error */ 
}