closesocket()

轉載：http://baike.baidu.com/view/569187.htm
簡述：

　　關閉一個套介面。

　　#include <winsock.h>

　　int PASCAL FAR closesocket( SOCKET s);

　　s：一個套介面的描述字。

　　注釋：

　　本函數關閉一個套介面。更確切地說，它釋放套介面描述字s，以後對s的訪問均以WSAENOTSOCK錯誤返回。若本次為對套介面的最後一次訪問，則相應的名字資訊及資料隊列都將被釋放。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().