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

Header winsock2.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

setsockopt (Windows Sockets)
getsockopt (Windows Sockets)
closesocket