socket()

　　簡述：

　　建立一個套介面。

#include <winsock.h>

SOCKET PASCAL FAR socket( int af, int type, int protocol);

af：一個地址描述。目前僅支援AF_INET格式，也就是說ARPA Internet地址格式。

type：新套介面的型別描述。

protocol：套介面所用的協議。如呼叫者不想指定，可用0。

　　註釋：

socket()函式用於根據指定的地址族、資料型別和協議來分配一個套介面的描述字及其所用的資源。如果協議

protocol未指定（等於0），則使用預設的連線方式。

　　對於使用一給定地址族的某一特定套介面，只支援一種協議。但地址族可設為AF_UNSPEC（未指定），這樣的話協議引數就要指定了。協議號特定於進行通訊的“通訊域”。支援下述型別描述：

　　型別 解釋

SOCK_STREAM 提供有序的、可靠的、雙向的和基於連線的位元組流，使用帶外資料傳送機制，為Internet地址族使用TCP。

SOCK_DGRAM 支援無連線的、不可靠的和使用固定大小（通常很小）緩衝區的資料報服務，為Internet地址族使用UDP。

SOCK_STREAM型別的套介面為全雙向的位元組流。對於流類套介面，在接收或傳送資料前必需處於已連線狀態。用

呼叫建立與另一套介面的連線，連線成功後，即可用和recv()傳送資料。當會話結束後，呼叫closesocket()。帶外資料根據規定用send()和recv()來接收。

　　實現SOCK_STREAM型別套介面的通訊協議保證資料不會丟失也不會重複。如果終端協議有緩衝區空間，且資料不能在一定時間成功傳送，則認為連線中斷，其後續的呼叫也將以WSAETIMEOUT錯誤返回。

SOCK_DGRAM型別套介面允許使用和recvfrom()從任意埠傳送或接收資料報。如果這樣一個套介面用connect()與一個指定埠連線，則可用send()和recv()與該埠進行資料報的傳送與接收。

　　返回值：

　　若無錯誤發生，socket()返回引用新套介面的描述字。否則的話，返回INVAID_SOCKET錯誤，應用程式可通過WSAGetLastError()獲取相應錯誤程式碼。

　　錯誤程式碼：

WSANOTINITIALISED：在使用此API之前應首先成功地呼叫WSAStartup()。

WSAENETDOWN：WINDOWS套介面實現檢測到網路子系統失效。

WSAEAFNOSUPPORT：不支援指定的地址族。

WSAEINPROGRESS：一個阻塞的WINDOWS套介面呼叫正在執行中。

WSAEMFILE：無可用檔案描述字。

WSAENOBUFS：無可用緩衝區，無法建立套介面。

WSAEPROTONOSUPPORT：不支援指定的協議。

WSAEPROTOTYPE：指定的協議不適用於本套介面。

WSAESOCKTNOSUPPORT：本地址族中不支援該型別套介面。

bind()

　　簡述：

　　將一本地地址與一套介面捆綁。

#include <winsock.h>

int PASCAL FAR bind( SOCKET s, const struct sockaddr FAR* name,

int namelen);

s：標識一未捆綁套介面的描述字。

name：賦予套介面的地址。sockaddr結構定義如下：

struct sockaddr{

u_short sa_family;

char sa_data[14];

};

namelen：name名字的長度。

　　註釋：

　　本函式適用於未連線的資料報或流類套介面，在或呼叫前使用。當用建立套介面後，它便存在於一個名字空間（地址族）中，但並未賦名。bind()函式通過給一個未命名套介面分配一個本地名字來為套介面建立本地捆綁（主機地址/埠號）。

　　在Internet地址族中，一個名字包括幾個組成部分，對於SOCK_PROGRAM和SOCK_STREAM類套介面，名字由三部分組成：主機地址，協議號（顯式設定為UDP和TCP）和用以區分應用的埠號。如果一個應用並不關心分配給它的地址，則可將Internet地址設定為，或將埠號置為0。如果Internet地址段為INADDR_ANY，則可使用任意網路介面；在有多種主機環境下可簡化程式設計。如果埠號置為0，則WINDOWS套介面實現將給應用程式分配一個值在1024到5000之間的唯一的埠。應用程式可在bind()後用來獲知所分配的地址，但必需注意的是，getsockname()只有在套介面連線成功後才會填寫Internet地址，這是由於在多種主機環境下若干種Internet地址都是有效的。

　　如果一個應用程式需要把埠捆綁到超過1024－5000範圍的特定埠時，比如rsh需要捆綁到任一保留埠，則可如下程式設計：

SOCKADDR_IN sin;

SOCKET s;

u_short alport=IPPORT_RESERVED;

sin.sin_family=AF_INET;

sin.sin_addr.s_addr=0;

for (;;) {

sin.sin_port=htons(alport);

if (bind(s,(LPSOCKADDR)&sin, sizeof(sin))=0) {

/* it worked */

}

if (GetLastError()!=WSAEADDRINUSE) {

/* fail */

}

alport-;

if (alport=IPPORT_RESERVED/2) {

/* fail－all unassigned reserved ports are */

/* in use. */

}

}

　　返回值：

　　如無錯誤發生，則bind()返回

相關推薦