?第7章Winsock基礎
?本章專門講解編寫成功網絡應用程序時所需的基本知識和A P I調用。
?
?7.1 Winsock的初始化
每個Wi n s o c k應用都必須加載Winsock DLL的相應版本。如果調用Wi n s o c k之前，沒有加載
Wi n s o c k庫，這個函數就會返回一個S O C K E T _ E R R O R，錯誤信息是W S A N O T I N I T I A L I S E D。
加載Wi n s o c k庫是通過調用W S A S t a r t u p函數實現的。這個函數的定義如下：
int ?WSAStartup( WORD wVersionRequested,
?????????LPWSADATA?lpWSAData
?????????);
w Ve r s i o n R e q u e s t e d參數用于指定準備加載的Wi n s o c k庫的版本。高位字節指定所需要的
Wi n s o c k庫的副版本，而低位字節則是主版本。然后，可用宏M A K E W O R D ( X , Y )（其中，x是
高位字節， y是低位字節）方便地獲得w Ve r s i o n R e q u e s t e d的正確值。
l p W S A D a t a參數是指向L P W S A D ATA結構的指針， W S A S t a r t u p用其加載的庫版本有關的
信息填在這個結構中：

?typedef struct WSAData
?{
???WORD?wVersion;
???WORD?wHighVersion;
???char?szDescription[WSADESCRIPTION_LEN+1];
???char? saSystemStatus[WSASYS_STATUS_LEN+1];
???unsighd short iMaxSockets;
???unsighd short iMaxUdpDg;
???char FAR *?lpVendorInfo;
?}WSADATA,FAR * LPWSADATA;
?
?W S A S t a r t u p把第一個字段w Ve r s i o n設成打算使用的Wi n s o c k版本。w H i g h Ve r s i o n參數容
納的是現有的Wi n s o c k庫的最高版本。記住，這兩個字段中，高位字節代表的是Wi n s o c k副版
本，而低位字段代表的則是Wi n s o c k主版本。s z D e s c r i p t i o n和s z S y s t e m S t a t u s這兩個字段由特定
的Wi n s o c k 實施方案設定，事實上沒有用。不要使用下面這兩個字段： i M a x S o c k e t s和
i M a x U d p D g，它們是假定的同時最多可打開多少套接字和數據報的最大長度。然而，要知道
數據報的最大長度應該通過W S A E n u m P r o t o c o l s來查詢協議信息。同時最多打開套接字的數目
不是固定的，很大程度上和可用物理內存的多少有關。最后， l p Ve n d o r I n f o字段是為Wi n s o c k
實施方案有關的指定廠商信息預留的。任何一個Wi n 3 2平臺上都沒有使用這個字段。

7.2 錯誤檢查和控制
對編寫成功的Wi n s o c k應用程序而言，錯誤檢查和控制是至關重要的，因此，我們打算先
為大家介紹錯誤檢查和控制。事實上，對Wi n s o c k函數來說，返回錯誤是非常常見的。。但是，
多數情況下，這些錯誤都是無關緊要的，通信仍可在套接字上進行。盡管其返回的值并非一
成不變，但不成功的Wi n s o c k調用返回的最常見的值是S O C K E T _ E R R O R。
實際上， S O C K E T _ E R R O R常量是- 1。
如果調用一個Wi n s o c k函數，錯誤情況發生了，就可用W S A G e t L a s t E r r o r函數來獲得一段代碼，
這段代碼明確地表明發生的狀況。該函數的定義如下：

int WSAGetLastError(void);

發生錯誤之后調用這個函數，就會返回所發生的特定錯誤的完整代碼。W S A G e t L a s t E r r o r
函數返回的這些錯誤都已預定義常量值，為各種錯誤代碼定義的常量
（帶有#定義指令）一般都以W S A E開頭。

7.3 面向連接的協議
對服務器監聽的連接來說，它必須在一個已知的名字上。在T C P / I P中，這個名字就是
本地接口的I P地址，加上一個端口編號。每種協議都有一套不同的定址方案，所以有一種不
同的命名方法。在Wi n s o c k中，第一步是將指定協議的套接字綁定到它已知的名字上。這個過
程是通過A P I調用b i n d來完成的。下一步是將套接字置為監聽模式。這時，用A P I函數l i s t e n來
完成的。最后，若一個客戶機試圖建立連接，服務器必須通過a c c e p t或W S A A c c e p t調用來接
受連接。
1. bind
一旦為某種特定協議創建了套接字，就必須將套接字綁定到一個已知地址。b i n d函數可將
指定的套接字同一個已知地址綁定到一起。該函數聲明如下；

int bind(
?????SOCKET s,
?????const sturct sockaddr FAR * name,
?????int ?namelen
????);
?其中，第一個參數s代表我們希望在上面等待客戶機連接的那個套接字。第二個參數的類
型是struct sockaddr，它的作用很簡單，就是一個普通的緩沖區。針對自己打算使用的那個協
議，必須把該參數實際地填充一個地址緩沖區，并在調用b i n d時將其造型為一個s t r u c t
s o c k a d d r。
舉個例子來說，下列代碼闡述了在一個T C P連接上，如何來做到這一點：

SOCKET??s;
struct sockaddr_in tcpaddr;
int ??port=5150;
s = socket(AF_INET,SOCK_STREAM,IPPROTO_TCP);
tcpaddr.sin_family = AF_INET;
tcpaddr.sin_port = htons(port);
tcpaddr.sin_addr.s_addr = htonl(INADDR_ANY);

bind(s,(SOCKADDR *)&tcpaddr,sizeof(tcpaddr));

一旦出錯， b i n d 就會返回S O C K E T _ E R R O R 。對b i n d 來說，最常見的錯誤是
W S A E A D D R I N U S E。如使用的是T C P / I P，那么W S A E A D D R I N U S E就表示另一個進程已經同
本地I P接口和端口號綁定到了一起，或者那個I P接口和端口號處于T I M E _ WA I T狀態。假如你
針對一個套接字調用b i n d，但那個套接字已經綁定，便會返回W S A E F FA U LT錯誤。

2. listen
我們接下來要做的是將套接字置入監聽模式。b i n d函數的作用只是將一個套接字和一個
指定的地址關聯在一起。指示一個套接字等候進入連接的A P I函數則是l i s t e n，其定義如下：

int listen(
??????SOCKET s,
??????int backlog
?????);

第一個參數同樣是限定套接字。b a c k l o g參數指定了正在等待連接的最大隊列長度。這個
參數非常重要，因為完全可能同時出現幾個服務器連接請求。例如，假定b a c k l o g參數為2。如
果三個客戶機同時發出請求，那么頭兩個會被放在一個“待決”（等待處理）隊列中，以便應
用程序依次為它們提供服務。而第三個連接會造成一個W S A E C O N N R E F U S E D錯誤。注意，
一旦服務器接受了一個連接，那個連接請求就會從隊列中刪去，以便別人可繼續發出請求。
b a c k l o g參數其實本身就存在著限制，這個限制是由基層的協議提供者決定的。如果出現非法
值，那么會用與之最接近的一個合法值來取代。除此以外，對于如何知道實際的b a c k l o g值，
其實并不存在一種標準手段。
與l i s t e n對應的錯誤是非常直觀的。到目前為止，最常見的錯誤是W S A E I N VA L。該錯誤
通常意味著，你忘記在l i s t e n之前調用b i n d。否則，與b i n d調用相反，使用l i s t e n時可能收到
W S A E A D D R I N U S E。這個錯誤通常是在進行b i n d調用時發生的。

3. accept和W S A A c c e p t
現在，我們已做好了接受客戶連接的準備。這是通過a c c e p t或W S A A c c e p t函數來完成的。
a c c e p t格式如下：

SOCKET accept(
????????SOCKET s,
????????struct sockaddr FAR * addr,
????????int FAR * addrlen
???????);
其中，參數s是一個限定套接字，它處在監聽模式。第二個參數應該是一個有效的
S O C K A D D R _ I N結構的地址，而a d d r l e n應該是S O C K A D D R _ I N結構的長度。對于屬于另一種
協議的套接字，應當用與那種協議對應的S O C K A D D R結構來替換S O C K A D D R _ I N。通過對
a c c p e t函數的調用，可為待決連接隊列中的第一個連接請求提供服務。a c c e p t函數返回后，
a d d r結構中會包含發出連接請求的那個客戶機的I P地址信息，而a d d r l e n參數則指出結構的長
度。此外，a c c e p t會返回一個新的套接字描述符，它對應于已經接受的那個客戶機連接。對于
該客戶機后續的所有操作，都應使用這個新套接字。至于原來那個監聽套接字，它仍然用于
接受其他客戶機連接，而且仍處于監聽模式。

Winsock 2引入了一個名為W S A A c c e p t的函數。它能根據一個條件函數的返回值，選擇性
地接受一個連接。這個新函數的定義如下：

SOCKET WSAAccept(
?????????SOCKET? s,
?????????struct sockaddr FAR * addr,
?????????LPINT addlen,
?????????LPCONDITIONPROC lpfnCondition,
?????????DWORD ?dwCallbackData
????????);
?
其中，頭三個參數與a c c e p t的Winsock 1版本是相同的。l p f n C o n d i t i o n參數是指向一個函數
的指針，那個函數是根據客戶請求來調用的。該函數決定是否接受客戶的連接請求，定義如
下：

?int CALLBACK ConditionFunc(
????????????????LPWSABUF?lpCallerId,
????????????????LPWSABUF? lpCallerData,
????????????????LPQOS???lpSQOS,
????????????????LPQOS???lpGQOS,
????????????????LPWSABUF?lpCalleeId,
????????????????LPWSABUF? lpCalleeData,
????????????????GROUP FAR * g,
????????????????DWORD???dwCallbackData
???????????????);
?
?l p C a l l e r I d是一個值參數，其中包含連接實體的地址。W S A B U F結構是許多Winsock 2函數
常用的。對它的聲明如下：

typedef?struct __WSABUF{
?u_long?len;
?char FAR * buf;
?} WSABUF,FAR * LPWSABUF;
?對l p C a l l e r I d來說，b u f指針指向的是一個地址結構。該結構針對的是建立連接的那種特定
通信協議。為正確返回信息，只須將b u f指針建立為恰當的S O C K A D D R類型。在T C P / I P的情
況下，在S O C K A D D R _ I N結構中，當然應該包含建立連接的那個客戶機的I P地址。在連接請
求期間，大多數網絡協議都能提供對呼叫者I D信息的支持。
l p C a l l e r D a t a參數中包含了隨連接請求一道，由客戶機發出的任何連接數據。若其中未指
定呼叫者數據，那么該參數就默認為N U L L。要注意的是，對大多數網絡協議（如T C P）來說，
它們并不提供對連接數據的支持。至于一種協議到底是支持連接數據，還是支持斷開數據，
可用W S A E n u m P r o t o c o l s函數對Wi n s o c k目錄中相應的條目進行查詢，從而得出正確的結論。

l p S Q O S和l p G Q O S參數對客戶機請求的任何一個服務質量（ Q O S）參數進行指定，兩個
參數都引用了一個Q O S結構，該結構中包含的信息是關于收發數據所需要的帶寬。如果客戶
機沒有要求Q O S，這些參數都將是N U L L。這兩個參數的不同之處在于l p S Q O S指定的是一個
獨立的連接，而l p G Q O S則用于套接字組。在Winsock 1或2中沒有實施或支持套接字組

l p C l a l l e e I d屬于另一種W S A B U F結構，這一結構中包含已與客戶機需要與之連接的本地地
址。該結構的b u f字段同樣指向其相應地址家族的一個S O C K A D D R對象。對正在一個多主機
的機器上運行的服務器來說，這種信息非常有用。記住，如果服務器和I N A D D R _ A N Y地址綁
定在一起，任何一個網絡接口都可為連接請求提供服務。隨后，該參數會返回實際建立連接
的那個接口。
l p C l a l l e e D a t a參數是l p C a l l e r D a t a的補充。l p C a l l e e D a t a參數指向一個W S A B U F結構，服務
器可利用這個結構把數據當作連接請求進程的一部分，返回客戶機。如果服務提供者支持這
一選項， l e n字段就會指出作為這個連接請求一部分，服務器最多可向客戶機返回多少字節。
這種情況下，服務器會根據這一數量，將盡可能多的字節復制到W S A B U F結構的b u f部分，同
時用l e n字段指出實際傳輸了多少個字節。如果服務器不想返回任何連接數據，那么，在返回
之前，條件接受函數應將l e n字段設為0。假如提供者不支持連接數據， l e n字段就會為0。大多
數協議同樣都不支持在接受連接之前進行數據交換。事實上， Wi n 3 2平臺當前支持的所有協議
都不支持這一特性。
服務器將傳遞給條件函數的參數處理完之后，必須指出到底是接受、拒絕還是延后客戶機的連接請求。如果服務器打算接受連接，那么條件函數就應返回C F _ A C C E P T。如果拒絕，
函數就應返回C F _ R E J E C T。如果出于某種原因，現在還不能做出決定，就應返回C F _ D E F E R。
若服務器準備對這個連接請求進行處理，就應調用W S A A c c c e p t。要注意的是，條件函數在與
W S A A c c e p t函數相同的進程內運行，而且會立即返回。另外還要注意的是，對于當前的
Wi n 3 2平臺支持的協議來說，條件接受函數并不意味著客戶機的連接請求必須在從該函數返回
一個值之后才會得到滿足。大多數情況下，最基層的網絡堆棧在條件接受函數調用的那一刻，
就已經接受了連接。如果返回C F _ R E J E C T值，基層堆棧就會將連接簡單地關閉了事。
如發生錯誤，就會返回I N VA L I D _ S O C K E T。最常見的錯誤是W S A E W O U L D B L O C K。如
果監聽套接字處于異步狀態或非暫停模式，同時沒有要接受的連接時，就會產生此類的錯誤。
若條件函數返回C F _ D E F E R，W S A A c c e p t就會返回W S AT RY _ A G A I N錯誤。如果條件函數返
回C F _ R E J E C T，W S A A c c e p t錯誤就是W S A E C O N N R E F U S E D。

????