禁止在一個套接口上進行數據的接收與傳送。
#include
int PASCAL FAR shutdown( SOCKET s, int how);
s:用於標識一個套接口的描述字。
how:標誌,用於描述禁止哪些操作。
注釋:
shutdown()函式用於任何類型的套接口禁止接收、禁止傳送或禁止收發。
如果how參數為0,則該套接口上的後續接收操作將被禁止。這對於低層協定無影響。對於TCP協定,TCP視窗不改變並接收前來的數據(但不確認)直至視窗滿。對於UDP協定,接收並排隊前來的數據。任何情況下都不會產生ICMP錯誤包。
若how為1,則禁止後續傳送操作。對於TCP,將傳送FIN。
若how為2,則同時禁止收和發。
請注意shutdown()函式並不關閉套接口,且套接口所占有的資源將被一直保持到 closesocket()調用。
評註:
無論SO_LINGER設定與否,shutdown()函式不會阻塞。
一個應用程式不應依賴於重用一個已被shutdown()禁止的套接口。特別地,一個WINDOWS套接口實現不必支持在這樣的套接口上使用connect()調用。
返回值:
如果沒有錯誤發生,shutdown()返回0。否則的話,返回SOCKET_ERROR錯誤,應用程式可通過 WSAGetLastError()獲取相應 錯誤代碼。
錯誤代碼:
WSANOTINITIALISED:在使用此API之前應首先成功地調用 WSAStartup()。
WSAENETDOWN:WINDOWS套接口實現檢測到網路子系統失效。
WSAEINVAL:how 參數非法。
WSAEINPROGRESS:一個阻塞的WINDOWS套接口調用正在運行中。
WSAENOTCONN:套接口未連線(僅適用於SOCK_STREAM類型套接口)。
WSAENOTSOCK:描述字不是一個套接口。
參見:
connect(), socket().
相關詞條
-
shutdown
Windows 系統自帶一個名為Shutdown.exe的程式,可以用於關機操作(位置在Windows\System32下),一般情況下Windows系...
操作命令 注意要點 實際套用 環境使用 -
shutdown()
shutdown 請注意shutdown WSAEINVAL:how參數非法。
-
AgataSoft Shutdown Pro V2.8
自AgataSoft Shutdown Pro V2.8動關機工具,AgataSoft Shutdown的某些“關機”狀態達到了最小CPU占用。它具有多...
軟體簡介 作用與特點 -
PC Auto Shutdown V3.66
軟體大小: 軟體語言: 軟體類別:
軟體介紹 軟體功能 -
Auto Shutdown Genius V2.1.3
軟體大小:1458 KB 軟體語言:英文 軟體類別:國外軟體 / 共享版 / 開關定時 套用平台: Win9x/NT/2000/XP/2003。
軟體介紹 軟體功能 -
Okoker Shutdown Expert V1.9
是一款在你指定的時間中快捷有效的幫助關機,重啟,註銷電腦的工具。它提供了不同的方法來確定關機事件的時間,比如以每一天,剛剛運行開始等等,你可以選擇你喜歡...
基本介紹 主要功能 -
流控制傳輸協定
ACK和SHUTDOWN COMPLETE數據塊外,其他類型的多個數據...。包含INIT數據塊的分組中驗證標籤必須為0。在包含SHUTDOWN... SHUTDOWN-ACK數據塊的分組中複製。在包含ABORT數據塊的分組中,驗證...
介紹 報文格式 特點 工作過程 C++實例 -
Linux系統管理命令
shutdown命令shutdown 命令可以安全地關閉或重啟Linux系統,它在...: shutdown 【選項】 【時間】 【警告信息】 命令中各選項的含義為... 取消一個已經運行的shutdown。需要特別說明的是,該命令只能由...
wall命令 write命令