【導(dǎo)讀】的將要被轉(zhuǎn)換為網(wǎng)絡(luò)字節(jié)順序的32位數(shù)，u_long表示無(wú)符號(hào)長(zhǎng)整型數(shù)。s：傳入?yún)?shù)，在Winsock2提供的擴(kuò)展格式中增加了。標(biāo)識(shí)套接口的描述字。這兩個(gè)函數(shù)的返回值差別較大，在使用時(shí)一定要注意。)函數(shù)來(lái)說(shuō)，如果該函數(shù)被調(diào)用時(shí)正確執(zhí)行，則這個(gè)函數(shù)返回一個(gè)32位的TCP/IP網(wǎng)絡(luò)字節(jié)順序的數(shù)。的數(shù)據(jù)是指針參數(shù)lplong所指向的數(shù)。)函數(shù)取得對(duì)該錯(cuò)誤的具體描述。WSANOTINITIALISED：在調(diào)用本API之前應(yīng)。WSAENETDOWN：網(wǎng)絡(luò)子系統(tǒng)失效。WSAENOTSOCK：描述字不是一個(gè)套接口。用戶地址空間中?？梢詤⒖嫉?章的網(wǎng)絡(luò)程序?qū)嵗?。lphostshort：傳出參數(shù)，指向一個(gè)16位主機(jī)字

　　

【正文】 所需選項(xiàng)的整型量或結(jié)構(gòu)量 ， 而 optlen則為整形量或結(jié)構(gòu)量的長(zhǎng)度 。 還要注意一個(gè)問(wèn)題 ， 套接口的有些屬性值既可以設(shè)置 (即可以使用 setsockopt(?)函數(shù) )， 也可以獲取 (即使用 getsockopt(?)函數(shù) )， 但有些套接口屬性只能獲取或只能設(shè)置 。 后 面 要 介 紹 的 其 他 兩 種 選 項(xiàng) 級(jí) 別 (IPPROTO_IP 和IPPROTO_TCP)與 SOL_SOCKET選項(xiàng)級(jí)別的情況類似 。 表 81所示為在 SOL_SOCKET選項(xiàng)級(jí)別下的各種選項(xiàng) 。 第 8章 Winsock API 表 81 SOL_SOCKET選項(xiàng)級(jí)別下的各選項(xiàng) O p t n a m e ( 選項(xiàng)名 ) 數(shù)據(jù)類型 獲取 / 設(shè)置 說(shuō) 明 S O _ A CC E P T CO N N BO O L 獲取 如為 T RU E ，表明套接口處于監(jiān)聽(tīng)模式 S O _ BR O A D CA S T BO O L 獲取 / 設(shè)置 如為 T RU E ，表明套接口已 設(shè) 置 為允許 發(fā)送廣播消息 模式 S O _ CO N N E CT _ T IM E i n t 獲取 返回套接口建立連接的時(shí)間，以秒為單位 S O _ D E BU G BO O L 獲取 / 設(shè)置 如果是 T RU E ，就允許調(diào)試輸出 S O _ L IN G E R S t ru c t L i n g e r 獲取 / 設(shè)置 設(shè)置或獲取當(dāng)前的時(shí)延值 S O _ D O N T L IN G E R BO O L 獲取 / 設(shè)置 如果是 T RU E ，則禁用 S O _ L IN G E R S O _ D O N T RO U T E BO O L 獲取 / 設(shè)置 如果是 T RU E ，便直接向網(wǎng)絡(luò)接口發(fā)送消息， 無(wú)需 查詢路由表 信息 S O _ E RR O R i n t 獲取 返回并清除錯(cuò)誤狀態(tài) S O _ E X CL U S IV E A D D RU S E BO O L 獲取 / 設(shè)置 如果是 T RU E ，套接口綁定的那個(gè)本地端口就不能重新被另一個(gè)進(jìn)程使用 第 8章 Winsock API 續(xù)表 O p t n a m e ( 選項(xiàng)名 ) 數(shù)據(jù)類型 獲取 / 設(shè)置 說(shuō) 明 S O _ K E E P A L IV E BO O L 獲取 / 設(shè)置 如果是 T RU E ，套接口就會(huì)進(jìn)行配置，在會(huì)話過(guò)程中發(fā)送 “ 保持活動(dòng) ” 消息 S O _ M A X _ M S G _ S IZ E 無(wú)符號(hào)整數(shù) 獲取 對(duì)一個(gè)面向消息的套接口來(lái)說(shuō)，這是一條消息的最大長(zhǎng)度 S O _ O O BIN L IN E BO O L 獲取 / 設(shè)置 如果是 T RU E ，帶外數(shù)據(jù)就會(huì)在普通數(shù)據(jù)流中 S O _ P RO T O CO L _ IN F O W S A P RO T O CO L _ IN F O 獲取 與套接口綁定的協(xié)議信息 S O _ RCV B UF i n t 獲取 / 設(shè)置 接收緩沖區(qū)長(zhǎng)度 S O _ RE U S E A D D R BO O L 獲取 / 設(shè)置 如果是 T RU E ，套接口就可與一個(gè)正由其他套接口使用的地址綁定到一起，或與處在 T IM E _ W A IT 狀態(tài)的地址綁定到一起 S O _ R V CT IM E O i n t 獲取 / 設(shè)置 用于設(shè)置一個(gè)阻塞套接口上的接收超時(shí)值 ( 以毫秒為單位 ) S O _ S N D BU F i n t 獲取 / 設(shè)置 發(fā)送數(shù)據(jù)緩沖區(qū)長(zhǎng)度 S O _ T Y P E i n t 獲取 返回指定套接口的類型 ( 如 S O C K _ D G RA M 和 S O CK _ S T RE A M 等 ) S O _ S N D T IM E O i n t 獲取 / 設(shè)置 獲取或設(shè)置套接口上的數(shù)據(jù)發(fā)送超時(shí)時(shí)間 ( 以毫秒為單位 ) 第 8章 Winsock API (1) ?SO_ACCEPTCONN：該選項(xiàng)只能獲取 。 如果已通過(guò) listen(?)函數(shù)調(diào)用 ,??套接口將進(jìn)入監(jiān)聽(tīng)模式 ， 這時(shí)獲取這個(gè)選項(xiàng)時(shí)就會(huì)返回 TRUE。 數(shù)據(jù)報(bào)類型的套接口(SOCK_DGRAM)不支持這一選項(xiàng) 。 (2) ?SO_BROADCAST:??該選項(xiàng)可以獲取也可以設(shè)置 。如果指定的套接口該選項(xiàng)已經(jīng)設(shè)置為 TRUE， 則允許套接口廣播收發(fā)信息 。 該選項(xiàng)只有對(duì)非 SOCK_STREAM類型的所有套接口才是有效的 。 第 8章 Winsock API 廣播是一種特殊的數(shù)據(jù)發(fā)送方法 ， 使本地子網(wǎng)上的所有機(jī)器都能收到相同的數(shù)據(jù) 。 廣播通信的缺點(diǎn)在于假如同時(shí)有許多進(jìn)程發(fā)送廣播數(shù)據(jù) ， 網(wǎng)絡(luò)立刻就會(huì)擁擠不堪 ， 造成網(wǎng)絡(luò)性能大大降低 ， 甚至有可能陷入癱瘓 。 要想接收一條廣播消息 ， 首先必須啟用廣播選項(xiàng) ， 然后使用某個(gè)數(shù)據(jù)報(bào)接收函數(shù) ， 比如 recvfrom(?)或WSARecvFrom(?)。 該選項(xiàng)的設(shè)置方法如下： 第 8章 Winsock API …… BOOL bBroadcast=TRUE。 //創(chuàng)建一個(gè)數(shù)據(jù)報(bào)套接口 s=socket(AF_INET,SOCK_DGRAM,0)。 …… //設(shè)置廣播選項(xiàng) if(setsocketopt(s,SOL_SOCKET,SO_BROADCAST,(char*)amp。bBroadcast,sizeof (BOOL))==SOCKET_ERROR) { printf(39。39。setsocketopt(?) Error:u%\n39。39。,WSAGetLastError(?))。 return。 } …… 第 8章 Winsock API (3) ?SO_CONNECT_TIME：該選項(xiàng)只能獲取 。 它是一個(gè)微軟 Windows操作系統(tǒng)專用選項(xiàng) ， 用于返回連接建立的時(shí)間 ， 以秒為單位 。 該選項(xiàng)可以在客戶端的 SOCKET句柄上調(diào)用 ， 以判斷連接是否已經(jīng)建立 ， 以及建立了多長(zhǎng)時(shí)間 。若套接口當(dāng)前尚未建立連接 ， 返回值便是 0xFFFFFFFF。 (4) ?SO_DEBUG：該選項(xiàng)值可以獲取 ， 也可以設(shè)置 。在應(yīng)用程序設(shè)置了 SO_DEBUG選項(xiàng)的情況下 ， 系統(tǒng)將記錄調(diào)試信息 。 至于調(diào)試信息如何展示 ， 要取決于服務(wù)提供者的基層實(shí)施方式 。 要想打開(kāi)調(diào)試信息 ， 可調(diào)用 setsockopt(?)函數(shù)設(shè)置 SO_DEBUG為 TRUE。 若用 SO_DEBUG選項(xiàng)調(diào)用getsockopt(?)函數(shù) ， 會(huì)返回 TRUE或 FALSE， 分別代表允許和禁止記錄調(diào)試信息 。 但目前尚無(wú)任何一種 Win32平臺(tái)支持的 SO_DEBUG選項(xiàng) 。 第 8章 Winsock API (5) ?SO_LINGER：該選項(xiàng)值可以獲取 ， 也可以設(shè)置 。 該選項(xiàng)不能使用在 SOCK_DGRAM類型的套接口上 。 它用于控制在 closesocket(?)函數(shù)已執(zhí)行的情況下 ，如何處理套接口數(shù)據(jù)排列上未發(fā)送完畢的數(shù)據(jù) 。 該選項(xiàng)要通過(guò) linger結(jié)構(gòu)來(lái)設(shè)置 ， 該結(jié)構(gòu)的定義如下： struct linger{ int l_onoff。 int l_linger。 }。 第 8章 Winsock API l_onoff字段用來(lái)控制 SO_LINGER選項(xiàng)的打開(kāi)或關(guān)閉 ， 為了使該選項(xiàng)起作用 ， 該字段應(yīng)該設(shè)置為一個(gè)非 0的值 。 l_linger字段表示延遲時(shí)間 ， 以秒為單位 。 當(dāng) l_onoff和 l_linger字段取不同的值時(shí) ， 系統(tǒng)的操作方式也不同 ， 它們的取值情況如表 82所示 。 第 8章 Winsock API 表 82 SO_LINGER選項(xiàng)取值情況說(shuō)明 l _ o n o ff l _ l i n g e r S O _ L IN G E R 說(shuō) 明 ≠ 0 ≠ 0 設(shè)置 這種取值意味著當(dāng)調(diào)用 c l o s e s o c k e t ( ) 函數(shù)關(guān)閉一個(gè)套接口時(shí)，進(jìn)程將進(jìn)入睡眠狀態(tài) ( 即被阻塞 ) ，直到所剩數(shù)據(jù)發(fā)送完畢或超出規(guī)定的時(shí)間 ( 超時(shí)時(shí)間由 l _ l i n g e r 設(shè)定 ) ，這種關(guān)閉稱為“優(yōu)雅”的關(guān)閉，因?yàn)樗粫?huì)造成數(shù)據(jù)的丟失。請(qǐng)注意，如果套接口設(shè)置為非阻塞模式且 S O _ L IN G E R 設(shè)為非 0 的超時(shí)值，則 c l o s e s o c k e t ( ) 調(diào)用將以W S A E W O U L D BL O CK 錯(cuò)誤返回 ≠ 0 =0 設(shè)置 調(diào)用 c l o s e s o c k e t ( ) 函數(shù)時(shí)，套接口的 T CP 連接被立即關(guān)閉，套接口緩沖區(qū)中未發(fā)送的數(shù)據(jù)丟失，因此這種關(guān)閉方式稱為“強(qiáng)制”或“野蠻”關(guān)閉。因?yàn)樘捉涌诘奶撾娐妨⒓幢粡?fù)位 ( 發(fā)送一個(gè) RS T 給對(duì)方 ) ，且丟失了未發(fā)送的所有數(shù)據(jù)，此時(shí)在遠(yuǎn)端的 re c v ( ) 調(diào)用將以W S A E CO N N RE S E T 出錯(cuò) =0 — 關(guān)閉 系統(tǒng)執(zhí)行默認(rèn)的操作， l _ l i n g e r 參數(shù)將被忽略， c l o s e s o c k e t ( ) 將立即返回 第 8章 Winsock API (6) ?SO_DONTLINGER：該選項(xiàng)值可以獲取，也可以設(shè)置。若在一個(gè)流類套接口上設(shè)置了 SO_DONTLINGER選項(xiàng)，也就是說(shuō)將 linger結(jié)構(gòu)的 l_onoff域設(shè)為 0，則closesocket(?)調(diào)用立即返回，但是，如果可能，排隊(duì)的數(shù)據(jù)將在套接口關(guān)閉之前被發(fā)送。 SO_DONTLINGER和SO_LINGER選項(xiàng)將直接影響使用 closesocket(?)函數(shù)關(guān)閉一個(gè)套接口時(shí)系統(tǒng)對(duì)套接口的操作行為。表 83總結(jié)了這兩個(gè)選項(xiàng)對(duì)套接口關(guān)閉方式的影響。 第 8章 Winsock API 表 83 SO_DONTLINGER和 SO_LINGER選項(xiàng) 對(duì)套接口關(guān)閉方式的影響 選 項(xiàng) 間隔時(shí)間 套接口關(guān)閉方式 套接口在關(guān)閉前是否等待 S O _ D O N T L IN G E R 不關(guān)心 優(yōu)雅 否 S O _ L IN G E R 0 強(qiáng)制 否 S O _ L IN G E R ≠ 0 優(yōu)雅 是 第 8章 Winsock API (7) ?SO_DONTROUTE：該選項(xiàng)可以獲取，也可以設(shè)置。 (8) ?SO_ERROR：該選項(xiàng)只能獲取，用于返回以具體套接口為基礎(chǔ)的錯(cuò)誤代碼，在返回后系統(tǒng)一般將該選項(xiàng)設(shè)置為 0。 (9) ?SO_KEEPALIVE：該選項(xiàng)可以獲取，也可以設(shè)置，它只適用于以 TCP為基礎(chǔ)的套接口。在 Windows 95及Windows 98操作系統(tǒng)中，這兩個(gè)鍵都位于下述注冊(cè)表路徑中： \HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\VxD\MSTCP 第 8章 Winsock API 而在 Windows NT和 Windows 20xx中 ， 這兩個(gè)鍵位于下述位置： \HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\TCPIP\Parameters 服務(wù)器 (例如 FTP服務(wù)器 )一般要設(shè)置該選項(xiàng) ， 這樣當(dāng)客戶在非正常終止連接的情況下 ， 經(jīng)過(guò)一段時(shí)間后 ， 服務(wù)器也能終止該連接 。 (10) ?SO_MAX_MSG_SIZE：該選項(xiàng)只能獲取。 (11) ?SO_OOBINLINE：該選項(xiàng)可以獲取，也可以設(shè)置。 第 8章 Winsock API (12) ?SO_PROTOCOL_INFO：該選項(xiàng)只能獲取 ， 獲取WSAPROTCOL_INFO結(jié)構(gòu)中與套接口關(guān)聯(lián)在一起的協(xié)議特征信息 。 該選項(xiàng)由 Winsock 2支持 。 (13) ?SO_RCVBUF：該選項(xiàng)可以獲取，也可以設(shè)置。 (14) ?SO_SNDBUF：該選項(xiàng)可以獲取 ， 也可以設(shè)置 。 與SO_RCVBUF選項(xiàng)相對(duì)應(yīng) ， 該選項(xiàng)用于確定發(fā)送緩沖區(qū)的大小 。 (15) ?SO_TYPE：該選項(xiàng)只能獲取 ,??用于返回指定套接口的類型 。 可能的套接口類型包括 SOCK_DGRAM 、SOCK_STREAM和 SOCK_RAW。 (16) ?SO_SNDTIMEO：該選項(xiàng)可以獲取，也可以設(shè)置。 第 8章 Winsock API (17) ?SO_RCVTIMEO：該選項(xiàng)可以獲取，也可以設(shè)置。 (18) ?SO_REUSEADDR：該選項(xiàng)可以獲取，也可以設(shè)置，表示該套接口能和一個(gè)已在使用中的地址捆綁。 (19) ?SO_EXCLUSIVEADDRUSE：該選項(xiàng)可以獲取，也可以設(shè)置。該選項(xiàng)的作用是禁止其他進(jìn)程在一