[信息与通信]第五章 套接口库函数参考.docVIP

第五章 套接口库函数参考 5.1 Windows Socket 1.1库函数参考 本章以字母顺序列出了套接口库函数，并介绍了技术细节。 使用任一库函数时应在程序中包含WINSOCK.H头文件。在附录A.2中还列出了一些与BERKELEY兼容的头文件。这些头文件只起到兼容性的作用，它们都包含了WINSOCK.H头文件，WINDOWS.H头文件也是必需的，但WINSOCK.H会视需要包含这一头文件。 5.1.1 accept() 简述： 在一个套接口接受一个连接。 #include winsock.h SOCKET PASCAL FAR accept( SOCKET s, struct sockaddr FAR* addr, int FAR* addrlen); s：套接口描述字，该套接口在listen()后监听连接。 addr：（可选）指针，指向一缓冲区，其中接收为通讯层所知的连接实体的地址。Addr参数的实际格式由套接口创建时所产生的地址族确定。 addrlen：（可选）指针，指向存有addr地址长度的整形数。 注释： 本函数从s的等待连接队列中抽取第一个连接，创建一个与s同类的新的套接口并返回句柄。如果队列中无等待连接，且套接口为非阻塞方式，则accept()阻塞调用进程直至新的连接出现。如果套接口为非阻塞方式且队列中等待连接，则accept()返回一错误代码。已接受连接的套接口不能用于接受新的连接，原套接口仍保持开放。 addr参数为一个返回参数，其中填写的是为通讯层所知的连接实体地址。addr参数的实际格式由通讯时产生的地址族确定。addrlen参数也是一个返回参数，在调用时初始化为addr所指的地址空间；在调用结束时它包含了实际返回的地址的长度（用字节数表示）。该函数与SOCK_STREAM类型的面向连接的套接口一起使用。如果addr与addrlen中有一个为零NULL，将不返回所接受的套接口远程地址的任何信息。 返回值： 如果没有错误产生，则accept()返回一个描述所接受包的SOCKET类型的值。否则的话，返回INVALID_SOCKET错误，应用程序可通过调用WSAGetLastError()来获得特定的错误代码。 addrlen所指的整形数初始时包含addr所指地址空间的大小，在返回时它包含实际返回地址的字节长度。 错误代码： WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。 WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。 WSAEFAULT：addrlen参数太小（小于socket结构的大小）。 WSAEINTR：通过一个WSACancelBlockingCall()来取消一个（阻塞的）调用。 WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。 WSAEINVAL：在accept()前未激活listen()。 WSAEMFILE：调用accept()时队列为空，无可用的描述字。 WSAENOBUFS：无可用缓冲区空间。 WSAENOTSOCK：描述字不是一个套接口。 WSAEOPNOTSUPP：该套接口类型不支持面向连接服务。 WSAEWOULDBLOCK：该套接口为非阻塞方式且无连接可供接受。 参见： bind(), connect(), listen(), select(), socket(), WSAAsyncSelect(). 5.1.2 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名字的长度。 注释： 本函数适用于未连接的数据报或流类套接口，在connect()或listen()调用前使用。当用socket()创建套接口后，它便存在于一个名字空间（地址族）中，但并未赋名。bind()函数通过给一个未命名套接口分配一个本地名字来为套接口建立本地捆绑（主机地址/断口号）。 在Internet地址族中，一个名字包括几个组成部分，对于SOCK_PGRAM和SOCK_STREAM类套接口，名字由三部分组成：主机地址，协议号（显式设