Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This structure maintains information about a specific socket that specifies how that socket should behave when data is queued to be sent and the closesocketfunction 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 closesocketfunction 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_onoffto a nonzero value, set l_lingerto 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_onoffshould be set to zero and setsockoptshould 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 |