共用方式為

LPWSPSENDDISCONNECT 回呼函式 (ws2spi.h)

  • 發行項

LPWSPSendDisconnect 函式會起始套接字聯機的終止，並傳送中斷連線數據。

語法

LPWSPSENDDISCONNECT Lpwspsenddisconnect;

int Lpwspsenddisconnect(
  [in]  SOCKET s,
  [in]  LPWSABUF lpOutboundDisconnectData,
  [out] LPINT lpErrno
)
{...}

參數

[in] s

識別套接字的描述項。

[in] lpOutboundDisconnectData

連出中斷聯機數據的指標。

[out] lpErrno

錯誤碼的指標。

傳回值

如果沒有發生錯誤， LPWSPSendDisconnect 會傳回零。 否則會傳回SOCKET_ERROR的值，並在 lpErrno 中提供特定的錯誤碼。

錯誤碼 意義
WSAENETDOWN
 網路子系統失敗。
WSAENOPROTOOPT
 參數 lpOutboundDisconnectData 不是 Null，而且服務提供者不支援中斷聯機數據。
WSAEINPROGRESS
 封鎖 Windows Sockets 呼叫正在進行中，或服務提供者仍在處理回呼函式。
WSAENOTCONN
 套接字未 (連線導向套接字) 。
WSAENOTSOCK
 描述項不是套接字。
WSAEFAULT
 lpOutboundDisconnectData 參數未完全包含在用戶地址空間的有效部分。

備註

LPWSPSendDisconnect 函式用於連接導向的套接字上，以停用傳輸，以及起始連線終止以及中斷連線數據的傳輸。

成功發出此函式之後，不允許後續傳送。

如果不是 null，lpOutboundDisconnectData 參數會指向緩衝區，其中包含要傳送給遠端合作對象的傳出中斷聯機數據。

請注意， LPWSPSendDisconnect 不會關閉套接字，而且在 叫用 LPWSPCloseSocket 之前，不會釋放附加至套接字的資源。

注意

不論套接字上的SO_LINGER設定為何， LPWSPSendDisconnect 函式都不會封鎖。 Windows Sockets SPI 用戶端不應該依賴在中斷聯機之後重複使用套接字。 特別是，Windows Sockets 提供者不需要支援在這類套接字上使用 LPWSPConnect 。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 ws2spi.h

另請參閱

LPWSPConnect

LPWSPSocket