linger

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure maintains information about a specific socket that specifies how that socket should behave when data is queued to be sent and the closesocket function is called.

Syntax

struct linger {
  u_short l_onoff;
  u_short l_linger;
};

Members

• l_onoff
  Specifies whether a socket should remain open for a specified amount of time after a closesocket function call to enable queued data to be sent.

• l_linger
  Enabling SO_LINGER also disables SO_DONTLINGER, and vice versa. Note that if SO_DONTLINGER is DISABLED (that is, SO_LINGER is ENABLED) then no time-out value is specified. In this case, the time-out used is implementation dependent. If a previous time-out has been established for a socket (by enabling SO_LINGER), this time-out value should be reinstated by the service provider.

Remarks

To enable SO_LINGER, the application should set l_onoff to a nonzero value, set l_linger to zero or the desired time-out (in seconds), and call the setsockopt (Windows Sockets) function. To specify SO_DONTLINGER (that is, disable SO_LINGER) l_onoff should be set to zero and setsockopt should be called. Note that enabling SO_LINGER with a nonzero timeout on a nonblocking socket is not recommended.

Requirements

See Also

Reference

setsockopt (Windows Sockets)
getsockopt (Windows Sockets)
closesocket