linger
A version of this page is also available for
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