bind()函数

将一本地地址与一 套接口捆绑。本函数适用于未连接的数据报或流类套接口，在 connect()或 listen()调用前使用。当用 socket()创建套接口后，它便存在于一个名字空间（地址族）中，但并未赋名。bind()函数通过给一个 未命名套接口分配一个本地名字来为套接口建立本地捆绑（ 主机地址/ 端口号）。

目录

1. 1 简述
2. 2 用法
3. 3 返回值
4. 4 错误代码

简述

编辑

将一本地地址与一套接口捆绑。

在windows 环境下为：

#include < winsock.h>

int PASCAL FAR bind( SOCKET sockaddr, const struct sockaddr FAR* my_addr,int addrlen);

在linux 环境下为：

#include <sys/types.h>

#include <sys/socket.h>

int bind( int sockfd , const struct sockaddr * my_addr, socklen_t addrlen);

sockaddr：标识一未捆绑 套接口的描述字。

my_addr：赋予套接口的地址。sockaddr结构定义如下：

struct sockaddr{

u_short sa_family;

char sa_data[14];

};

addrlen：name名字的长度。

返回：成功返回0，失败返回-1.

参数列表中，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需要捆绑到任一保留端口，则可如下编程：

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()返回0。否则的话，将返回-1，应用程序可通过WSAGetLastError()获取相应 错误代码。

错误代码

编辑

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

WSAENETDOWN： 套接口实现检测到网络子系统失效。

WSAEADDRINUSE：所定端口已在使用中（参见setoption()中的SO_REUSEADDR选项）。

WSAEFAULT：namelen参数太小（小于sockaddr结构的大小）。

WSAEINPROGRESS：一个阻塞的套接口调用正在运行中。

WSAEAFNOSUPPORT：本协议不支持所指定的地址族。

WSAEINVAL：该 套接口已与一个地址捆绑。

WSAENOBUFS：无足够可用缓冲区，连接过多。

WSAENOTSOCK：描述字不是一个套接口。