closesocket()

關閉一個套接口。

#include <winsock.h>

int PASCAL FAR closesocket( SOCKET s);

s：一個套接口的描述字。

closesocket()的語義受SO_LINGER與SO_DONTLINGER選項影響，對比如下：

選項 間隔 關閉方式 等待關閉與否

SO_DONTLINGER 不關心 優雅 否

SO_LINGER 零 強制 否

SO_LINGER 非零 優雅 是

若設置了SO_LINGER（亦即linger結構中的l_onoff域設為非零），並設置了零超時間隔，則closesocket()不被阻塞立即執行，不論是否有排隊數據未發送或未被確認。這種關閉方式稱為“強制”或“失效”關閉，因為套接口的虛電路立即被複位，且丟失了未發送的數據。在遠端的recv()調用將以WSAECONNRESET出錯。

若設置了SO_LINGER並確定了非零的超時間隔，則closesocket()調用阻塞進程，直到所剩數據發送完畢或超時。這種關閉稱為“優雅的”關閉。請注意如果套接口置為非阻塞且SO_LINGER設為非零超時，則closesocket()調用將以WSAEWOULDBLOCK錯誤返回。

若在一個流類套接口上設置了SO_DONTLINGER（也就是説將linger結構的l_onoff域設為零）；則closesocket()調用立即返回。但是，如果可能，排隊的數據將在套接口關閉前發送。請注意，在這種情況下WINDOWS套接口實現將在一段不確定的時間內保留套接口以及其他資源，這對於想用所以套接口的應用程序來説有一定影響。

返回值：

如無錯誤發生，則closesocket()返回0。否則的話，返回SOCKET_ERROR錯誤，應用程序可通過WSAGetLastError()獲取相應錯誤代碼。

WSANOTINITIALISED：在使用此API之前應首先成功地調用WSAStartup()。

WSAENETDOWN：WINDOWS套接口實現檢測到網絡子系統失效。

WSAENOTSOCK：描述字不是一個套接口。

WSAEINPROGRESS：一個阻塞的WINDOWS套接口調用正在運行中。

WSAEINTR：通過一個WSACancelBlockingCall()來取消一個（阻塞的）調用。

WSAEWOULDBLOCK：該套接口設置為非阻塞方式且SO_LINGER設置為非零超時間隔。

參見：

accept(), socket(), ioctlsocket(), setsockopt(), WSAAsyncSelect().