accept

使用格式

#include <winsock.h>

SOCKET  accept( SOCKET s, struct sockaddr FAR* addr,int FAR* addrlen);

 

功能描述

在一个套接口接受一个连接。本函数从s的等待连接队列中抽取第一个连接，创建一个与s同类的新的套接口并返回句柄

 

参数

s：        套接口描述字，该套接口在 listen() 后监听连接。

addr：（可选）指针，指向一缓冲区，其中接收为通讯层所知的连接实体的地址。Addr参数的实际格式由套接口创建时所产生的地址族确定。

addrlen：（可选）指针，输入参数，配合addr一起使用，指向存有addr地址长度的整型数。

 

返回值

如果没有错误产生，则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：该套接口为非阻塞方式且无连接可供接受。