WINDOWS環境下SOCKET基本函數

(1)WSAStartup函數

int WSAStartup(WORD wVersionRequested,LPWSADATA lpWSAData);

使用Socket的程序在使用Socket之前必須調用WSAStartup函數。該函數的第一個參數指明程序請求使用的Socket版本,其中高位字節指明副版本、低位字節指明主版本;操作系統利用第二個參數返回請求的Socket的版本信息。當一個應用程序調用WSAStartup函數時,操作系統根據請求的Socket版本來搜索相應的Socket庫,然後綁定找到的Socket庫到該應用程序中。以後應用程序就可以調用所請求的Socket庫中的其它Socket函數了。該函數執行成功後返回0。 
例:假如一個程序要使用2.1版本的Socket,那麼程序代碼如下
wVersionRequested = MAKEWORD( 2, 2 ); 
err = WSAStartup( wVersionRequested, &wsaData );

 

(2)WSACleanup函數 
int WSACleanup (void); 
應用程序在完成對請求的Socket庫的使用後,要調用WSACleanup函數來解
除與Socket庫的綁定並且釋放Socket庫所佔用的系統資源。


(3)socket函數
SOCKET socket( int af, int type, int protocol ); 
應用程序調用socket函數來創建一個能夠進行網絡通信的套接字。第一個
參數指定應用程序使用的通信協議的協議族,對於TCP/IP協議族,該參數置AF_INET;第二個參數指定要創建的套接字類型,流套接字類型爲SOCK_STREAM、數據報套接字類型爲SOCK_DGRAM;第三個參數指定應用程序所使用的通信協議。該函數如果調用成功就返回新創建的套接字的描述符,如果失敗就返回INVALID_SOCKET。套接字描述符是一個整數類型的值。每個進程的進程空間裏都有一個套接字描述符表,該表中存放着套接字描述符和套接字數據結構的對應關係。該表中有一個字段存放新創建的套接字的描述符,另一個字段存放套接字數據結構的地址,因此根據套接字描述符就可以找到其對應的套接字數據結構。每個進程在自己的進程空間裏都有一個套接字描述符表但是套接字數據結構都是在操作系統的內核緩衝裏。socket()默認創建的套接字是可重疊I/0的,如果使用WSASocket要創建可以重疊I/0的需要在最後一個參數了設置。下面是一個創建流套接字的例子: 
struct protoent *ppe; 
ppe=getprotobyname("tcp"); 
SOCKET ListenSocket=socket(AF_INET,SOCK_STREAM,ppe->p_proto);

 

(4)closesocket函數 
int closesocket( SOCKET s ); 
closesocket函數用來關閉一個描述符爲s套接字。由於每個進程中都有
一個套接字描述符表,表中的每個套接字描述符都對應了一個位於操作系統緩衝區中的套接字數據結構,因此有可能有幾個套接字描述符指向同一個套接字數據結構。套接字數據結構中專門有一個字段存放該結構的被引用次數,即有多少個套接字描述符指向該結構。當調用closesocket函數時,操作系統先檢查套接字數據結構中的該字段的值,如果爲1,就表明只有一個套接字描述符指向它,因此操作系統就先把s在套接字描述符表中對應的那條表項清除,並且釋放s對應的套接字數據結構;如果該字段大於1,那麼操作系統僅僅清除s在套接字描述符表中的對應表項,並且把s對應的套接字數據結構的引用次數減1。 
closesocket函數如果執行成功就返回0,否則返回SOCKET_ERROR。


(5)send函數 
int send( SOCKET s, const char FAR *buf, int len, int flags ); 
不論是客戶還是服務器應用程序都用send函數來向TCP連接的另一端發送數據。客戶程序一般用send函數向服務器發送請求,而服務器則通常用send函數來向客戶程序發送應答。該函數的第一個參數指定發送端套接字描述符;第二個參數指明一個存放應用程序要發送數據的緩衝區;第三個參數指明實際要發送的數據的字節數;第四個參數一般置0。這裏只描述同步Socket的send函數的執行流程。當調用該函數時,send先比較待發送數據的長度len和套接字s的發送緩衝區的長度,如果len大於s的發送緩衝區的長度,該函數返回SOCKET_ERROR(所以發送數據時要注意這點);如果len小於或者等於s的發送緩衝區的長度,那麼send先檢查協議是否正在發送s的發送緩衝中的數據,如果是就等待協議把數據發送完,如果協議還沒有開始發送s的發送緩衝中的數據或者s的發送緩衝中沒有數據,那麼send就比較s的發送緩衝區的剩餘空間和len,如果len大於剩餘空間大小send就一直等待協議把s的發送緩衝中的數據發送完,如果len小於剩餘空間大小send就僅僅把buf中的數據copy到剩餘空間裏(注意並不是send把s的發送緩衝中的數據傳到連接的另一端的,而是協議傳的,send僅僅是把buf中的數據copy到s的發送緩衝區的剩餘空間裏)。如果send函數copy數據成功,就返回實際copy的字節數,如果send在copy數據時出現錯誤,那麼send就返回SOCKET_ERROR;如果send在等待協議傳送數據時網絡斷開的話,那麼send函數也返回SOCKET_ERROR。要注意send函數把buf中的數據成功copy到s的發送緩衝的剩餘空間裏後它就返回了,但是此時這些數據並不一定馬上被傳到連接的另一端。如果協議在後續的傳送過程中出現網絡錯誤的話,那麼下一個Socket函數就會返回SOCKET_ERROR。(每一個除send外的Socket函數在執行的最開始總要先等待套接字的發送緩衝中的數據被協議傳送完畢才能繼續,如果在等待時出現網絡錯誤,那麼該Socket函數就返回SOCKET_ERROR) 
注意:在Unix系統下,如果send在等待協議傳送數據時網絡斷開的話,調用send的進程會接收到一個SIGPIPE信號,進程對該信號的默認處理是進程終止。


(6)recv函數 
int recv( SOCKET s, char FAR *buf, int len, int flags ); 
不論是客戶還是服務器應用程序都用recv函數從TCP連接的另一端接收數
據。該函數的第一個參數指定接收端套接字描述符;第二個參數指明一個緩衝區,該緩衝區用來存放recv函數接收到的數據;第三個參數指明buf的長度;第四個參數一般置0。這裏只描述同步Socket的recv函數的執行流程。當應用程序調用recv函數時,recv先等待s的發送緩衝中的數據被協議傳送完畢,如果協議在傳送s的發送緩衝中的數據時出現網絡錯誤,那麼recv函數返回SOCKET_ERROR,如果s的發送緩衝中沒有數據或者數據被協議成功發送完畢後,recv先檢查套接字s的接收緩衝區,如果s接收緩衝區中沒有數據或者協議正在接收數據,那麼recv就一直等待,只到協議把數據接收完畢。當協議把數據接收完畢,recv函數就把s的接收緩衝中的數據copy到buf中(注意協議接收到的數據可能大於buf的長度,所以在這種情況下要調用幾次recv函數才能把s的接收緩衝中的數據copy完。recv函數僅僅是copy數據,真正的接收數據是協議來完成的),recv函數返回其實際copy的字節數。如果recv在copy時出錯,那麼它返回SOCKET_ERROR;如果recv函數在等待協議接收數據時網絡中斷了,那麼它返回0。 
注意:在Unix系統下,如果recv函數在等待協議接收數據時網絡斷開了,那麼調用recv的進程會接收到一個SIGPIPE信號,進程對該信號的默認處理是進程終止。


(7)bind函數 
int bind( SOCKET s, const struct sockaddr FAR *name, int namelen ); 
    當創建了一個Socket以後,套接字數據結構中有一個默認的IP地址和默認的端口號。一個服務程序必須調用bind函數來給其綁定一個IP地址和一個特定的端口號。客戶程序一般不必調用bind函數來爲其Socket綁定IP地址和端口號。該函數的第一個參數指定待綁定的Socket描述符;第二個參數指定一個sockaddr結構,該結構是這樣定義的: 
struct sockaddr { 
u_short sa_family; 
char sa_data[14]; 
}; 
sa_family指定地址族,對於TCP/IP協議族的套接字,給其置AF_INET。當對TCP/IP協議族的套接字進行綁定時,我們通常使用另一個地址結構: 
struct sockaddr_in { 
short sin_family; 
u_short sin_port; 
struct in_addr sin_addr; 
char sin_zero[8]; 
}; 
其中sin_family置AF_INET;sin_port指明端口號;sin_addr結構體中只有一個唯一的字段s_addr,表示IP地址,該字段是一個整數,一般用函數inet_addr()把字符串形式的IP地址轉換成unsigned long型的整數值後再置給s_addr。有的服務器是多宿主機,至少有兩個網卡,那麼運行在這樣的服務器上的服務程序在爲其Socket綁定IP地址時可以把htonl(INADDR_ANY)置給s_addr,這樣做的好處是不論哪個網段上的客戶程序都能與該服務程序通信;如果只給運行在多宿主機上的服務程序的Socket綁定一個固定的IP地址,那麼就只有與該IP地址處於同一個網段上的客戶程序才能與該服務程序通信。我們用0來填充sin_zero數組,目的是讓sockaddr_in結構的大小與sockaddr結構的大小一致。下面是一個bind函數調用的例子: 
struct sockaddr_in saddr; 
saddr.sin_family = AF_INET; 
saddr.sin_port = htons(8888); 
saddr.sin_addr.s_addr = htonl(INADDR_ANY); 
bind(ListenSocket,(struct sockaddr *)&saddr,sizeof(saddr));

 

(8)listen函數 
int listen( SOCKET s, int backlog ); 
服務程序可以調用listen函數使其流套接字s處於監聽狀態。處於監聽狀態的流套接字s將維護一個客戶連接請求隊列,該隊列最多容納backlog個客戶連接請求。假如該函數執行成功,則返回0;如果執行失敗,則返回SOCKET_ERROR。

 

(9)accept函數 
SOCKET accept( SOCKET s, struct sockaddr FAR *addr, int FAR *addrlen ); 
服務程序調用accept函數從處於監聽狀態的流套接字s的客戶連接請求隊列中取出排在最前的一個客戶請求,並且創建一個新的套接字來與客戶套接字創建連接通道,如果連接成功,就返回新創建的套接字的描述符,以後與客戶套接字交換數據的是新創建的套接字;如果失敗就返回INVALID_SOCKET。該函數的第一個參數指定處於監聽狀態的流套接字;操作系統利用第二個參數來返回新創建的套接字的地址結構;操作系統利用第三個參數來返回新創建的套接字的地址結構的長度。下面是一個調用accept的例子:
struct sockaddr_in ServerSocketAddr; 
int addrlen; 
addrlen=sizeof(ServerSocketAddr); 
ServerSocket=accept(ListenSocket,(struct sockaddr *)&ServerSocketAddr,&addrlen);


(10)connect函數 
int connect( SOCKET s, const struct sockaddr FAR *name, int namelen ); 
客戶程序調用connect函數來使客戶Socket s與監聽於name所指定的計算機的特定端口上的服務Socket進行連接。如果連接成功,connect返回0;如果失敗則返回SOCKET_ERROR。下面是一個例子: 
struct sockaddr_in daddr; 
memset((void *)&daddr,0,sizeof(daddr)); 
daddr.sin_family=AF_INET; 
daddr.sin_port=htons(8888); 
daddr.sin_addr.s_addr=inet_addr("133.197.22.4"); 
connect(ClientSocket,(struct sockaddr *)&daddr,sizeof(daddr));

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章