WSPSendDisconnect (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function initiates termination of the connection for the socket and sends disconnect data.

Note

WSPSendDisconnect is not supported for the default TCP/UDP provider in Windows Embedded CE. However, third parties can implement their own provider and have support for this function if they choose.

Syntax

int WSPSendDisconnect(
  SOCKET s,
  LPWSABUF lpOutboundDisconnectData,
  LPINT lpErrno 
);

Parameters

  • s
    [in] A descriptor identifying a socket.
  • lpOutboundDisconnectData
    [in] A pointer to the outgoing disconnect data.
  • lpErrno
    [out] A pointer to the error code.

Return Value

This function always returns SOCKET_ERROR and sets lpErrno to WSASYSCALLFAILURE on Windows Embedded CE.

Remarks

This function is used on connection-oriented sockets to disable transmission, and to initiate termination of the connection along with the transmission of disconnect data, if any.

After this function has been successfully issued, subsequent sends are disallowed.

lpOutboundDisconnectData, if not NULL, points to a buffer containing the outgoing disconnect data to be sent to the remote party.

Note

WSPSendDisconnect does not close the socket, and that resources attached to the socket will not be freed until WSPCloseSocket is invoked.

Note

WSPSendDisconnect does not block regardless of the SO_LINGER setting on the socket.

Note

A Windows Sockets SPI client should not rely on being able to reuse a socket after it has been disconnected. In particular, a Windows Sockets provider is not required to support the use of WSPConnect on such a socket.

Requirements

Header ws2spi.h
Library Ws2.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Winsock SPI Functions
WSPConnect
WSPSocket