|
簡述:
通知套接口有請(qǐng)求事件發(fā)生.
#include <winsock.h>
int PASCAL FAR WSAAsyncSelect ( SOCKET s, HWND hWnd,
unsigned int wMsg, long lEvent );
s 標(biāo)識(shí)一個(gè)需要事件通知的套接口的描述符.
hWnd 標(biāo)識(shí)一個(gè)在網(wǎng)絡(luò)事件發(fā)生時(shí)需要接收消息的窗口句柄.
wMsg 在網(wǎng)絡(luò)事件發(fā)生時(shí)要接收的消息.
lEvent 位屏蔽碼,用于指明應(yīng)用程序感興趣的網(wǎng)絡(luò)事件集合.
注釋:
本函數(shù)用來請(qǐng)求Windows Sockets DLL為窗口句柄發(fā)一條消息－無論它何時(shí)檢測到由lEvent參數(shù)指明的網(wǎng)絡(luò)事件.要發(fā)送的消息由wMsg參數(shù)標(biāo)明.被通知的套接口由s標(biāo)識(shí).
本函數(shù)自動(dòng)將套接口設(shè)置為非阻塞模式.
lEvent參數(shù)由下表中列出的值組成.
值 意義
FD_READ 欲接收讀準(zhǔn)備好的通知.
FD_WRITE 欲接收寫準(zhǔn)備好的通知.
FD_OOB 欲接收帶邊數(shù)據(jù)到達(dá)的通知.
FD_ACCEPT 欲接收將要連接的通知.
FD_CONNECT 欲接收已連接好的通知.
FD_CLOSE 欲接收套接口關(guān)閉的通知.
啟動(dòng)一個(gè)WSAAsyncSelect()將使為同一個(gè)套接口啟動(dòng)的所有先前的WSAAsyncSelect()作廢. 例如,要接收讀寫通知,應(yīng)用程序必須同時(shí)用FD_READ和FD_WRITE調(diào)用WSAAsyncSelect(),如下:
rc = WSAAsyncSelect(s, hWnd, wMsg, FD_READ|FD_WRITE);
對(duì)不同的事件區(qū)分不同的消息是不可能的.下面的代碼將不會(huì)工作;第二個(gè)調(diào)用將會(huì)使第一次調(diào)用的作用失效,只有FD_WRITE會(huì)通過wMsg2消息通知到.
rc = WSAAsyncSelect(s, hWnd, wMsg1, FD_READ);
rc = WSAAsyncSelect(s, hWnd, wMsg2, FD_WRITE);
如果要取消所有的通知,也就是指出Windows Sockets的實(shí)現(xiàn)不再在套接口上發(fā)送任何和網(wǎng)絡(luò)事件相關(guān)的消息,則lEvent應(yīng)置為0.
rc = WSAAsyncSelect(s, hWnd, 0, 0);
盡管在本例中,WSAAsyncSelect()立即使傳給該套接口的事件消息無效, 仍有可能有消息等在應(yīng)用程序的消息隊(duì)列中.應(yīng)用程序因此也必須仍準(zhǔn)備好接收網(wǎng)絡(luò)消息－即使消息作廢.用closesocket()關(guān)閉一個(gè)套接口也同樣使WSAAsyncSelect()發(fā)送的消息作廢,但在closesocke()之前隊(duì)列中的消息仍然起作用.
由于一個(gè)已調(diào)用accept()的套接口和用來接收它的偵聽套接口有同樣的屬性, 任何為偵聽套接口設(shè)置的的WSAAsyncSelect()事件也同樣對(duì)已接收的套接口起作用.例如, 如果一個(gè)偵聽的套接口有WSAAsyncSelect()事件FD_ACCEPT,FD_READ,FD_WRITE, 則任何在那個(gè)偵聽的套接口上接收的套接口將也有FD_ACCEPT,FD_READ,FD_WRITE事件,以及同樣的wMsg的值.若需要不同的wMsg及事件,應(yīng)用程序應(yīng)調(diào)用WSAAsyncSelect(),將已接收的套接口和想要發(fā)送的新消息作為參數(shù)傳遞.
當(dāng)某一套接口s上發(fā)生了一個(gè)已命名的網(wǎng)絡(luò)事件,應(yīng)用程序窗口hWnd會(huì)接收到消息wMsg.wParam參數(shù)標(biāo)識(shí)了網(wǎng)絡(luò)事件發(fā)生的套接口.lParam的低字指明了發(fā)生的網(wǎng)絡(luò)事件.lParam的高字則含有一個(gè)錯(cuò)誤代碼.該錯(cuò)誤代碼可以是winsock.h中定義的任何錯(cuò)誤.
錯(cuò)誤代碼和事件可以通過WSAGETSELECTERRORH和WSAGETSELECTEVENT宏從lParam中取出.定義如下:
#define WSAGETSELECTERROR(lParam) HIWORD(lParam)
#define WSAGETSELECTEVENT(lParam) LOWORD(lParam)
注意:在accept()調(diào)用和為改變事件或wMsg的WSAAsyncSelect()調(diào)用中有一個(gè)計(jì)時(shí)窗口.應(yīng)用程序如果需要給偵聽的和調(diào)用過accept()的套接口以不同的wMsg,它就應(yīng)該在偵聽的套接口上請(qǐng)求FD_ACCEPT事件,然后在accept()調(diào)用后設(shè)置相應(yīng)的事件.由于FD_ACCEPT從不發(fā)送給已連接的套接口,而FD_READ,FD_WRITE,FD_OOB及FD_CLOSE也從不發(fā)送給偵聽套接口,所以不會(huì)產(chǎn)生困難.
使用以上的宏將最大限度的提高應(yīng)用程序的可移植性.
返回的可能網(wǎng)絡(luò)事件如下:
值 意義
FD_READ 套接口s準(zhǔn)備讀
FD_WRITE 套接口s準(zhǔn)備寫
FD_OOB 帶外數(shù)據(jù)準(zhǔn)備好在套接口s上讀.
FD_ACCEPT 套接口s準(zhǔn)備接收新的將要到來的連接.
FD_CONNECT 套接口s上的連接完成.
FD_CLOSE 由套接口s標(biāo)識(shí)的連接已關(guān)閉.
返回值:
0 若應(yīng)用程序感興趣的網(wǎng)絡(luò)事件的聲明成功.
SOCKET_ERROR 否則.可通過調(diào)用WSAGetLastError()返回特定的錯(cuò)誤代碼.
評(píng)價(jià):
盡管WSAAsyncSelect()可以以多個(gè)事件的組合來調(diào)用,應(yīng)用程序窗口還是會(huì)為每個(gè)網(wǎng)絡(luò)事件接收一條消息.
如同select()函數(shù),WSAAsyncSelect()會(huì)被頻繁地調(diào)用來決定,何時(shí)一次數(shù)據(jù)轉(zhuǎn)移操作(send()或recv())可以啟動(dòng),并且可以立刻成功.盡管如此,健壯的應(yīng)用程序必須做好這樣的準(zhǔn)備, 即它可能接收到消息及啟動(dòng)了一個(gè)會(huì)立即返回WSAEWOULDBLOCK的Windows Sockets API調(diào)用.例如,下列的事件序列是可能的:
(i) 數(shù)據(jù)到達(dá)套接口s;Windows Sockets傳遞WSAAsyncSelect消息.
(ii) 應(yīng)用程序處理其它一些消息.
(iii) 在處理過程中,應(yīng)用程序啟動(dòng)了ioctlsocket(s,FIONREAD...)并且注意到有數(shù)據(jù)準(zhǔn)備好讀.
(iv) 應(yīng)用程序啟動(dòng)recv(s,...)來讀數(shù)據(jù).
(v) 應(yīng)用程序循環(huán)處理下一條消息,最終到達(dá)WSAAsyncSelect消息,表示數(shù)據(jù)已準(zhǔn)備好讀.
(vi) 應(yīng)用程序啟動(dòng)recv(s,...),但失敗并有錯(cuò)誤WSAEWOULDBLOCK.
其它的事件序列也是可能的.
Windows Sockets DLL不會(huì)不斷地為某一特定的網(wǎng)絡(luò)事件向一個(gè)應(yīng)用程序發(fā)送消息. 如果已成功地向應(yīng)用程序窗口發(fā)送了一特定事件的通知,對(duì)該應(yīng)用程序窗口將不再為該網(wǎng)絡(luò)事件發(fā)消息,直到應(yīng)用程序調(diào)用函數(shù)隱含地重新通知該網(wǎng)絡(luò)事件.
事件 重新通知函數(shù)
FD_READ recv()或recvfrom()
FD_WRITE send()或sendto()
FD_OOB recv()
FD_ACCEPT accept()
FD_CONNECT 無
FD_CLOSE 無
任何對(duì)重新通知函數(shù)的調(diào)用,即使失敗,也會(huì)達(dá)到為相關(guān)事件發(fā)重新通知消息的效果.
對(duì)FD_READ,FD_OOB和FD_ACCEPT事件,消息傳遞是"水平觸發(fā)"(level-triggered)的.這意味著,若調(diào)用了重新通知函數(shù)并且相關(guān)的事件對(duì)該調(diào)用仍有效,WSAAsyncSelect()消息就將傳給應(yīng)用程序.這為應(yīng)用程序提供了事件驅(qū)動(dòng)以及不必考慮在任一時(shí)刻到達(dá)的數(shù)據(jù)量的能力.考慮下列序列:
(i) Windows Sockets DLL在套接口s上接收100字節(jié)的數(shù)據(jù)并傳遞一個(gè)FD_READ消息.
(ii) 應(yīng)用程序啟動(dòng)recv(s,buffptr,50,0)接收50字節(jié).
(iii) 由于仍有數(shù)據(jù)未讀,Windows Sockets DLL發(fā)送另一個(gè)FD_READ消息.
根據(jù)以上語義,應(yīng)用程序不必在收到FD_READ消息時(shí)讀進(jìn)所有可讀的數(shù)據(jù)－對(duì)應(yīng)于每一FD_READ消息進(jìn)行一次recv()調(diào)用是恰當(dāng)?shù)?如果應(yīng)用程序?yàn)橐粋€(gè)FD_READ消息而啟動(dòng)了多個(gè)recv()調(diào)用,它將接收到多個(gè)FD_READ消息.這樣的應(yīng)用程序可能希望在開始recv()調(diào)用( 通過不為FD_READ事件置位的WSAAsyncSelect()函數(shù)調(diào)用)之前關(guān)閉FD_READ消息.
如果在應(yīng)用程序初次調(diào)用WSAAsyncSelect()或當(dāng)調(diào)用了重新通知函數(shù)時(shí),有一個(gè)事件為真, 則會(huì)發(fā)送一個(gè)相應(yīng)的消息.例如,若應(yīng)用程序調(diào)用listen(),就會(huì)試圖進(jìn)行連接,然后應(yīng)用程序調(diào)用WSAAsyncSelect()聲明它需要為套接口接收FD_ACCEPT消息,Windows Sockets的實(shí)現(xiàn)就會(huì)立即傳遞一個(gè)FD_ACCEPT消息.
FD_WRITE事件處理起來稍有不同.FD_WRITE消息是在套接口第一次用connect()連接或由accept()接受,并且在send()或sendto()以WSAWOULDBLOCK錯(cuò)誤失敗后緩沖區(qū)空閑時(shí)發(fā)送的.因此,應(yīng)用程序可以假設(shè)發(fā)送可能在第一次FD_WRITE消息時(shí)開始,并持續(xù)到一次返回WSAEWOULDBLOCK的發(fā)送. 在這樣的失敗后,應(yīng)用程序?qū)⒈煌ㄖ?FD_WRITE消息的發(fā)送又將可能.
FD_OOB事件只用在當(dāng)套接口配置成獨(dú)立接收帶外數(shù)據(jù)時(shí).如果一個(gè)套接口被配置成接收感興趣的帶外數(shù)據(jù)狀態(tài),帶外數(shù)據(jù)將和普通數(shù)據(jù)等同視之,并且應(yīng)用程序應(yīng)該注冊(cè)它感興趣的方面,然后將接收FD_READ事件,而不是FD_OOB事件.應(yīng)用程序可以設(shè)置或監(jiān)控帶外數(shù)據(jù)處理的方法(通過使用setsockopt()或getsockopt()函數(shù),及SO_OOBINLINE選項(xiàng)).
在FD_CLOSE消息中的錯(cuò)誤代碼指出套接口的關(guān)閉是正常的還是異常的.如果錯(cuò)誤代碼是0,則關(guān)閉是正常的;若錯(cuò)誤代碼是WSAECONNRESET,則套接口的虛套接口將被重置.這些只對(duì)SOCK_STREAM類型的套接口起作用.
FD_CLOSE消息在相應(yīng)套接口的虛電路關(guān)閉指令接收到時(shí)發(fā)送.在TCP術(shù)語中,這意味著FD_CLOSE在連接進(jìn)入了FIN WAIT或CLOSE WAIT狀態(tài)時(shí)發(fā)送.這是遠(yuǎn)端對(duì)發(fā)送方進(jìn)行了shutdown()調(diào)用或closesocket()調(diào)用的結(jié)果.
請(qǐng)注意你的應(yīng)用程序?qū)⒅粫?huì)收到FD_CLOSE消息來指出虛電路的關(guān)閉.它不會(huì)收到FD_READ消息來表示該狀況.
錯(cuò)誤代碼:
WSANOTINITIALISED 在使用本API前必須進(jìn)行一次成功的WSAStartup()調(diào)用.
WSAENETDOWN WINDOWS SOCKETS實(shí)現(xiàn)已檢測到網(wǎng)絡(luò)子系統(tǒng)故障.
WSAEINVAL 指出指定的參數(shù)之一是非法的.
WSAEINPROGRESS 一個(gè)阻塞的Windows Sockets操作正在進(jìn)行.
附加的錯(cuò)誤代碼可能在應(yīng)用程序窗口接收到消息時(shí)被置.這些代碼可以用WSAGETSELECTERROR宏從lParam中取出.對(duì)應(yīng)于每個(gè)網(wǎng)絡(luò)事件的可能錯(cuò)誤代碼為:
事件:FD_CONNECT
WSAEADDRINUSE 給定的地址已被使用.
WSAEADDRNOTAVAIL 指定的地址在本地機(jī)器不能使用.
WSAEAFNOSUPPORT 指定族的地址不能和本套接口同時(shí)使用.
WSAECONNREFUSED 連接的嘗試被拒絕.
WSAEDESTADDRREQ 需要一個(gè)目的地址.
WSAEFAULT namelen參數(shù)不正確.
WSAEINVAL 套接口已經(jīng)約束到一個(gè)地址.
WSAEISCONN 套接口已經(jīng)連接.
WSAEMFILE 沒有可用的文件描述符.
WSAENETUNREACH 此時(shí)網(wǎng)絡(luò)不能從該主機(jī)訪問.
WSAENOBUFS 無可用的緩沖區(qū)空間.套接口不能連接.
WSAENOTCONN 套接口沒有連接.
WSAENOTSOCK 該描述符是文件,不是套接口.
WSAETIMEDOUT 試圖連接超時(shí),未建立連接.
事件:FD_CLOSE
WSAENETDOWN WINDOWS SOCKETS實(shí)現(xiàn)已檢測到網(wǎng)絡(luò)子系統(tǒng)故障.
WSAECONNRESET 連接由遠(yuǎn)端重建.
WSAECONNABORTED 由于超時(shí)或其它失敗放棄連接.
事件:FD_READ
事件:FD_WRITE
事件:FD_OOB
事件:FD_ACCEPT
WSAENETDOWN WINDOWS SOCKETS實(shí)現(xiàn)已檢測到網(wǎng)絡(luò)子系統(tǒng)故障.
關(guān)于Windows Sockets提供者的說明：
Windows Sockets的提供者應(yīng)確保消息可以成功地傳給應(yīng)用程序.如果PostMessag()操作失敗,Windows Sockets的實(shí)現(xiàn)必須重發(fā)該消息－只要窗口存在.
Windows Sockets提供者應(yīng)使用WSAMAKESELECTREPLY宏來構(gòu)造消息中的lParam參數(shù).
當(dāng)套接口關(guān)閉時(shí),Windows Sockets提供者應(yīng)清除所有保留下來要發(fā)送給應(yīng)用程序窗口的消息.然而應(yīng)用程序必須準(zhǔn)備好接收,放棄任何在closesocket()之前可能已經(jīng)發(fā)送的消息.
|