AcceptEx编辑

Windows套接字AcceptEx函数接受一个新的连接，返回本地和远程地址，并接收由客户端应用程序发送的第一块数据。Windows 95/98不支持AcceptEx函数。

平台SDK：Windows套接字

AcceptEx

注意：此函数是一个Microsoft特定的扩展，Windows Sockets规范。有关详细信息，请参阅Microsoft扩展和Windows Sockets 2。

BOOL AcceptEx（

IN SOCKET sListenSocket，

IN SOCKET sAcceptSocket，

IN PVOID lpOutputBuffer，

IN DWORD dwReceiveDataLength，

IN DWORD dwLocalAddressLength，

IN DWORD dwRemoteAddressLength，

OUT LPDWORD lpdwBytesReceived，

IN LPOVERLAPPED lpOverlapped

）;

参数

sListenSocket

[in]侦听套接字。服务器应用程序在这个套接字上等待连接。

sAcceptSocket

[in]将用于连接的套接字。此套接字必须不能已经绑定或者已经连接。

lpOutputBuffer

[in]指向一个缓冲区，该缓冲区用于接收新建连接的所发送数据的第一个块、该服务器的本地地址和客户端的远程地 址。接收到的数据将被写入到缓冲区0偏移处，而地址随后写入。 该参数必须指定，如果此参数设置为NULL，将不会得到执行，也无法通过GetAcceptExSockaddrs函数获得本地或远程的地址。

dwReceiveDataLength

[in]lpOutputBuffer字节数，指定接收数据缓冲区lpOutputBuffer的大小。这一大小应不包括服务器的本地地址的大小或客户端的远程地址，他们被追加到输出缓冲区。如果dwReceiveDataLength是零，AcceptEx将不等待接收任何数据，而是尽快建立连接。

dwLocalAddressLength

[in]为本地地址信息保留的字节数。此值必须比所用传输协议的最大地址大小长16个字节。

dwRemoteAddressLength

[in]为远程地址的信息保留的字节数。此值必须比所用传输协议的最大地址大小长16个字节。 该值不能为0。

dwBytesReceived

[out]指向一个DWORD用于标识接收到的字节数。此参数只有在同步模式下有意义。如果函数返回ERROR_IO_PENDING并在迟些时候完成操作，那么这个DWORD没有意义，这时你必须获得从完成通知机制中读取操作字节数。

lpOverlapped

[in]一个OVERLAPPED结构，用于处理请求。此参数必须指定，它不能为空。

返回值

如果没有错误发生，AcceptEx函数成功完成并返回TRUE。^[1] 

如果函数失败，AcceptEx返回FALSE。可以调用WSAGetLastError函数获得扩展的错误信息。如果WSAGetLastError返回ERROR_IO_PENDING，那么这次行动成功启动并仍在进行中。

备注

*在AcceptEx结合了几个socket函数的功能，acceptEx函数当成功时执行三项任务：

1. 一个新的连接被接受。

2. 返回连接的本地和远程地址。

3. 得到远程发送的第一个数据块。

*较accept函数而言，程序使用AcceptEx可以更快连接到一个套接字。

*输出缓冲区lpOutputBuffer存放内容包括：接收到的第一块数据、本地套接字地址（服务器）和远程套接字地址（客户端）。

使用单一的缓冲区可以提高性能，当使用AcceptEx时，必须使用GetAcceptExSockaddrs函数 将输出缓冲区的内容解析到三个不同部分的缓冲区 (data, local socket address, and remote socket address)。 在windows XP 及随后版本中,当 AcceptEx函数完成操作并且 SO_UPDATE_ACCEPT_CONTEXT选项在被接受的socket中被设置时, socket相关的本地地址（local address ）可以使用getsockname函数获得。类似的，与被接受socket 相关的远程端地址（the remote address)可以使用getpeername函数获得。

*本地和远程地址缓冲区的大小必须比使用传输协议的sockaddr地址大16个字节，是因为是以内部格式写入。例如，一个SOCKADDR_IN大小（TCP / IP协议的地址结构）是16个字节。因此，本地和远程地址缓冲区的大小必须指定至少32个字节。

*AcceptEx函数使用的重叠I / O。与使用accept相比，使用AcceptEx能以相对较少的线程数量处理大量的客户。如同所有的Win32重叠函数，Win32事件或完成端口都可用来作为完成通知机制。

AcceptEx和accept函数的另一个主要区别是，AcceptEx函数需要调用者提供两个套接字参数：

一个指定监听套接字。

一个指定接受连接的套接字。

该sAcceptSocket参数必须是一个已经打开的socket，不能是已绑定或者是已连接的socket。

*GetQueuedCompletionStatus函数或GetOverlappedResult函数的lpNumberOfBytesTransferred参数表明该请求接收到的字节数。

当此操作成功完成，sAcceptSocket可以使用，但只限下列功能：

ReadFile

WriteFile

发送

recv

TransmitFile

关闭套接字

注意：如果调用TransmitFile函数时，指定TF_DISCONNECT和TF_REUSE_SOCKET标志，指定套接字的已返回未绑定，未连接的状态。然后，您可以使用该套接字句柄作为AcceptEx函数的sAcceptSocket参数。但该套接字不能作为ConnectEx函数的参数。

当AcceptEx函数返回时，sAcceptSocket是一个已连接套接字。如未指定SO_UPDATE_ACCEPT_CONTEXT属性，sAcceptSocket不继承与sListenSocket参数相关套接字的属性。使用Setsockopt函数来设置SO_UPDATE_ACCEPT_CONTEXT选项，指定sAcceptSocket的套接字句柄和sListenSocket作为选项的值(specifying sAcceptSocketas the socket handle and sListenSocketas the option value) 。

例如：

error= setsockopt（sAcceptSocket，

SOL_SOCKET，

SO_UPDATE_ACCEPT_CONTEXT，

（char*）&sListenSocket，

sizeof（sListenSocket））;

如果提供了数据接收缓冲区（dwReceiveDataLength!=0），异步操作将在连接建立并且接收到第一 块数据后完成。使用getsockopt的SO_CONNECT_TIME选项来检查连接是否已经接受。如果它已被接受，您可以判断连接建立多久。该选项 的返回值是套接字连接已建立的秒数。如果套接字未连接，getsockopt返回0xFFFFFFFF。应用程序通过检查SO_CONNECT_TIME并结合检查异步操作是否完成，可以确定是否连接已建立了一段时间但没有收到任何数据。我们建议您终止这些连接，可以通过关闭连接强制AcceptEx完成操作，并返回一个错误状态。

例如：

int seconds;

BYTE opt = sizeof（seconds）;

error == getsockopt（sAcceptSocket，SOL_SOCKET，SO_CONNECT_TIME，

（char*）&seconds，（int）&opt）;

if（error= NO_ERROR）{

printf（“getsockopt（SO_CONNECT_TIME）失败：%d\ N”的，WSAGetLastError（））;

exit（1）;

}

Notes for ATM

没有与连接设置相关的重要问题时，使用Windows套接字2异步传输模式（ATM）。请参阅Windows套接字2备注部分承担重要的ATM连接设置信息函数文档。