bind

bind

將一本地地址與一套介面捆綁。本函數適用於未連接的數據報或流類套介面，在connect()或listen()調用前使用。當用socket()創建套介面后，它便存在於一個名字空間（地址族）中，但並未賦名。bind()函數通過給一個未命名套介面分配一個本地名字來為套介面建立本地捆綁（主機地址/埠號）。

目錄

1簡述 2用法 3返回值

簡述

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

在windows 環境下為：

在linux 環境下為：

參數列表中，sockfd 表示已經建立的socket編號（描述符）；

my_addr 是一個指向sockaddr結構體類型的指針；

參數addrlen表示my_addr結構的長度，可以用sizeof操作符獲得。

用法

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

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

返回值

如無錯誤發生，則bind()返回0。否則的話，將返回-1，應用程序可通過WSAGetLastError()獲取相應錯誤代碼。

錯誤代碼

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

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

WSAEADDRINUSE：所定埠已在使用中（參見setoption()中的SO_REUSEADDR選項）。

WSAEFAULT：namelen參數太小（小於sockaddr結構的大小）。

W徠SAEINPROGRESS：一個阻塞的套介面調用正在運行中。

WSAEAFNOSUPPORT：本協議不支持所指定的地址族。

WSAEINVAL：該套介面已與一個地址捆綁。

WSAENOBUFS：無足夠可用緩衝區，連接過多。

WSAENOTSOCK：描述字不是一個套介面。

參見：

connect(), listen(), getsockname(), setsockopt(), socket(), WSACancelBlockingCall().

目錄