WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
status = %SS_SELECT(socket, seconds, microseconds)
Returns SS_SUCCESS (0) or one of the errors in Error codes returned by %SS_SELECT below. (n)
A descriptor of an open socket created by %SS_SOCKET. (i4)
The number of seconds to wait for data to arrive on the socket. (n)
The number of microseconds to wait for data to arrive on the socket. (n)
Because it is virtually impossible to know when a message is going to be sent or how long it is going to be, you can use %SS_SELECT to wait for data to arrive on the specified socket or for the specified time to expire. If data is already available, %SS_SELECT returns immediately. If the specified time elapses before the message arrives, %SS_SELECT returns control to the calling program so that other computations may be performed before checking again to see if the message has arrived.
Seconds and microseconds can be used together to indicate traditional time. For example, if you want to wait 10.234 seconds, the seconds argument would be 10 and the microseconds argument would be 234000.
If a socket is lost while waiting for a packet, %SS_SELECT returns immediately but does not indicate that an error has occurred. See Handling lost sockets for more information.
If %SS_SELECT returns -1 and %SYSERR has SS_EINTR, retry the operation.
See the Socket Errors table for additional information about these errors.