在實際開發 WinSock 網路程式時,除了建立連線的基本流程之外,還有許多輔助函數能幫助我們取得錯誤資訊、處理位元組序轉換以及查詢主機位址。以下逐一梳理這些關鍵 API。
每當一次網路呼叫失敗,若想要針對具體問題進行診斷,就必須先取得對應的錯誤碼。
int WSAGetLastError(void); #define h_errno WSAGetLastError()
所有錯誤值的定義都可以在 Winsock2.h 中找到。
由於不同電腦採用不同的位元組儲存順序,任何傳入 Winsock 函數或由其回傳的 IP 位址與埠號,都必須以網路順序組織。
u_long htonl(u_long hostlong); // 範例:htonl(0)=0,htonl(80)=1342177280
這是上一個函數的逆向操作。
u_long ntohl(u_long netlong); // 範例:ntohl(0)=0,ntohl(1342177280)=80
原理與第 2 點相同,只是處理的是 unsigned short 型別。
u_short htons(u_short hostshort); // 範例:htons(0)=0,htons(80)=20480
u_short ntohs(u_short netshort); // 範例:ntohs(0)=0,ntohs(20480)=80
電腦內部並不認識如 192.1.8.84 這類字串形式的位址,因此需先轉換成 in_addr 結構,其本質就是一個 unsigned long 值。
unsigned long inet_addr(const char FAR * cp);
// 範例:inet_addr("192.1.8.84")=1409810880,inet_addr("127.0.0.1")=16777343
若發生錯誤,函數會回傳 INADDR_NONE。
char FAR * inet_ntoa(struct in_addr in); // 範例: char * ipaddr = NULL; char addr[20]; in_addr inaddr; inaddr.s_addr = 16777343; ipaddr = inet_ntoa(inaddr); strcpy(addr, ipaddr); // addr 此時變為 "127.0.0.1"
請注意,不要修改或釋放此函數的回傳值;失敗時它會回傳 NULL。
int getsockname(SOCKET s, struct sockaddr FAR * name, int FAR * namelen);
s 為 Socket;name 為呼叫後取得的位址;namelen 為緩衝區大小。
int getpeername(SOCKET s, struct sockaddr FAR * name, int FAR * namelen);
int gethostname(char FAR * name, int namelen);
// 用法:
char szName[255];
memset(szName, 0, 255);
if (gethostname(szName, 255) == SOCKET_ERROR) {
// 錯誤處理
}
// 執行後 szName 例如為 "xiaojin"
struct hostent FAR * gethostbyname(const char FAR * name);
// 用法:
hostent * host;
char * ip;
host = gethostbyname("xiaojin");
if (host != NULL && host->h_addr_list[0]) {
struct in_addr addr;
memmove(&addr, host->h_addr_list[0], 4);
ip = inet_ntoa(addr);
}
// host->h_name="xiaojin",host->h_addrtype=2 (AF_INET),host->length=4,ip="127.0.0.1"
為了解決上述問題,人們提出了多種 I/O 模型,以下介紹最常見的三種。
透過 select 函數,可以判定一個或多個 Socket 的狀態,例如是否有資料可讀、或能否向其寫入資料。
int select(int nfds, fd_set FAR * readfds, fd_set FAR * writefds,
fd_set FAR * exceptfds, const struct timeval FAR * timeout);
先來看看相關結構的定義:
a、fd_set 結構:
#define FD_SETSIZE 64
typedef struct fd_set {
u_int fd_count; /* 已設定的 Socket 數量 */
SOCKET fd_array[FD_SETSIZE]; /* Socket 陣列 */
} fd_set;
fd_count 記錄已設定的 Socket 數目,fd_array 則是 Socket 列表;FD_SETSIZE 為最大 Socket 數量,微軟建議不小於 64。
b、timeval 結構:
struct timeval {
long tv_sec; /* 秒 */
long tv_usec; /* 微秒 */
};
這個結構主要用來設定 select() 的等待時間,若設為 (0,0),select() 便會立即回傳。
接著看 select 各參數的作用:
readfds、writefds、exceptfds 三者至少要有一個不為空,且其中至少包含一個 Socket,否則就失去了呼叫 select 的意義。以下為測試某個 Socket 是否可讀的範例:
fd_set fdread;
FD_ZERO(&fdread);
FD_SET(s, &fdread);
if (select(0, &fdread, NULL, NULL, NULL) > 0) {
if (FD_ISSET(s, &fdread)) {
// 此 Socket 可讀
}
}
I/O 操作函數:主要用於取得與 Socket 相關的操作參數。
int ioctlsocket(SOCKET s, long cmd, u_long FAR * argp);
s 為目標 Socket,cmd 為操作命令,argp 為命令參數的指標。常見命令包括:
/* 取得已讀入的資料量 */
#define FIONREAD _IOR('f', 127, u_long)
/* 允許或禁止非阻塞模式,非 0 允許、0 禁止 */
#define FIONBIO _IOW('f', 126, u_long)
/* 判定帶外資料是否已全部讀入 */
#define SIOCATMARK _IOR('s', 7, u_long)
這是一個以 Windows 訊息為基礎的常用非同步 I/O 模型。呼叫 WSAAsyncSelect 會自動把 Socket 設為非阻塞模式,並向 Windows 註冊感興趣的網路事件,同時提供一個用來接收通知的視窗句柄。當事件發生時,對應視窗便會收到通知訊息。
int WSAAsyncSelect(SOCKET s, HWND hWnd, u_int wMsg, long lEvent);
s 為需要通知的 Socket;hWnd 為接收訊息的視窗句柄;wMsg 為要接收的訊息;lEvent 為指定感興趣事件組合的遮罩,主要包含:
#define FD_READ_BIT 0 #define FD_READ (1 << FD_READ_BIT) #define FD_WRITE_BIT 1 #define FD_WRITE (1 << FD_WRITE_BIT) #define FD_OOB_BIT 2 #define FD_OOB (1 << FD_OOB_BIT) #define FD_ACCEPT_BIT 3 #define FD_ACCEPT (1 << FD_ACCEPT_BIT) #define FD_CONNECT_BIT 4 #define FD_CONNECT (1 << FD_CONNECT_BIT) #define FD_CLOSE_BIT 5 #define FD_CLOSE (1 << FD_CLOSE_BIT)
例如要接收讀寫通知:
int nResult = WSAAsyncSelect(s, hWnd, wMsg, FD_READ | FD_WRITE);
if (nResult == SOCKET_ERROR) {
// 錯誤處理
}
// 取消通知:
int nResult = WSAAsyncSelect(s, hWnd, 0, 0);
當視窗 hWnd 收到訊息時,wParam 標識了 Socket,lParam 的低字標明網路事件,高字則包含錯誤碼。
此模型與 WSAAsyncSelect 類似,最大差別在於網路事件發生時會被送到一個事件物件句柄,而非視窗。使用步驟如下:
a、建立事件物件以接收網路事件:
#define WSAEVENT HANDLE #define LPWSAEVENT LPHANDLE WSAEVENT WSACreateEvent(void);
回傳值為一個事件物件句柄,具有「已傳信 (signaled)」與「未傳信 (nonsignaled)」兩種狀態,以及「人工重設」與「自動重設」兩種模式,預設為未傳信狀態與人工重設模式。
b、將事件物件與 Socket 關聯並註冊事件:
int WSAEventSelect(SOCKET s, WSAEVENT hEventObject, long lNetworkEvents);
s 為 Socket;hEventObject 為剛建立的事件物件句柄;lNetworkEvents 為事件遮罩。
c、I/O 處理後,將事件物件重設為未傳信:
BOOL WSAResetEvent(WSAEVENT hEvent);
成功回傳 TRUE,失敗回傳 FALSE。
d、等待網路事件觸發事件句柄:
DWORD WSAWaitForMultipleEvents(DWORD cEvents, const WSAEVENT FAR * lphEvents,
BOOL fWaitAll, DWORD dwTimeout, BOOL fAlertable);
lphEvents 為事件句柄陣列的指標;cEvents 為句柄數目,最大值為 WSA_MAXIMUM_WAIT_EVENTS;fWaitAll 指定等待類型(TRUE 表示全部有信號才回傳,FALSE 表示任一有信號即回傳);dwTimeout 為等待超時(毫秒);fAlertable 指定回傳時是否執行完成例程。
引用事件陣列中的事件時,應以 WSAWaitForMultipleEvents 的回傳值減去預先定義的 WSA_WAIT_EVENT_0,才能得到實際索引。例如:
nIndex = WSAWaitForMultipleEvents(...); MyEvent = EventArray[nIndex - WSA_WAIT_EVENT_0];
e、判定網路事件類型:
int WSAEnumNetworkEvents(SOCKET s, WSAEVENT hEventObject, LPWSANETWORKEVENTS lpNetworkEvents);
// 結構定義:
typedef struct _WSANETWORKEVENTS {
long lNetworkEvents;
int iErrorCode[FD_MAX_EVENTS];
} WSANETWORKEVENTS, FAR * LPWSANETWORKEVENTS;
f、關閉事件物件句柄:
BOOL WSACloseEvent(WSAEVENT hEvent);
呼叫成功回傳 TRUE,否則回傳 FALSE。