closesocket()

closesocket()計算機語言語法,功能為關閉一個套接口。

簡述

關閉一個套接口
#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().

相關詞條

相關搜尋

熱門詞條

聯絡我們