API及可伸缩性-AcceptEx

对可伸缩的TCP/IP服务器而言，最有用的扩展API也就算AcceptEx了。利用这个函数，服务器能够投递一个异步调用，该调用将接受下一个传入的客户机链接。

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是监听套接字，sAcceptSocket是一个有效的，为绑定的套接字句柄，将被分配到下一个客户机链接上。所以需在投递AcceptEx调用前建立客户机的套接字句柄。由于套接字建立开销比较大，这个步骤很必要，若是一个服务器但愿尽量快的处理客户机链接，它就须要一个已建立的套接字库，以便把新的链接分配进去。

sAcceptSocket以后紧随的4个参数相互关联。lpOutputBuffer参数含有用于客户机链接的本地或远程地址，还有一个可选的缓冲区，该缓冲区用来接收来自客户机的第一个数据块。dwReceiveDataLength指明所提供的缓冲区须要多少字节数，该缓冲区用来接收客户机发送的数据。应用程序若是不接收数据，可将其置为0。dwLocalAddressLength指定套接字地址结构大小，它至关于客户机套接字的地址族加上16个字节。客户机套接字链接的本地地址放在lpOutputBuffer参数中紧随接收数据以后的地方。dwRemoteAddresslength与lpOutputBuffer参数同样。客户机链接的远程地址将被写入前一个参数中，紧随接收数据及本地地址以后。应注意， dwReceiveDataLength参数能够是0，可是dwLocalAddressLength和 dwRemoteAddresslength参数均不能为0。

lpdwBytesReceived指明操做马上成功时，新建的客户机链接上所收到的字节数。lpOverlapped用于这个重叠操做的WSAOVERLAPPED结构，该参数是必须的---若是想执行一个阻塞的接收调用，使用accept或WSAAccept就好了。

示例代码，建立一个IPv4套接字并投递一个单一的AcceptEx：

SOCKET s,sClient;
HANDLE hComPort;
LPFN_ACCEPTEX lpfnAcceptEx = NULL;
GUID GuidAcceptEx = WSAID_ACCEPTEX;

WSAOVERLAPPEDPLUS ol;
SOCKADDR_IN salocal;
DWORD dwBytes;
char buf[1024];
int buflen = 1024;

//建立完成端口
hComPort = CreateIoCompletionPort(INVALID_HANDLE_VALUE,NULL,(ULONG_PTR)0,0);

//建立监听套接字
s = socket(AF_INET,SOCK_STREAM,IPPROTO_TCP);

//将套接字和完成端口关联起来
CreateIoCompletionPort((HANDLE)s,hComPort,(ULONG_PTR)0,0);

salocal.sin_family = AF_INET;
salocal.sin_port = htons(5050);
salocal.sin_addr.s_addr = htonl(INADDR_ANY);
bind(s, (SOCKADDR*)&salocal, sizeof(SOCKADDR_IN));

listen(s, 200);

//加载AcceptEx函数
WSAIoctl(s,
         SIO_GET_EXTENSION_FUNCTION_POINTER,
         &GuidAcceptEx,
         sizeof(GuidAcceptEx),
         &lpfnAcceptEx,
         sizeof(lpfnAcceptEx),
         &dwBytes,
         NULL,
         NULL);
//为已接收的链接建立客户机套接字
sClient = socket(AF_INET,SOCK_STREAM,IPPROTO_TCP);

//初始化扩展的重叠结构
memset(&ol, 0 ,sizeof(ol));
ol.operation = OP_ACCEPTEX;
ol.client = sClient;

lpfnAcceptEx(s,
             sClient,
             buf,
             buflen-((sizeof(SOCKADDR_IN)+16)*2),
             sizeof(SOCKADDR_IN)+16,
             sizeof(SOCKADDR_IN)+16,
             &dwBytes,
             &ol.overlapped);

//在完成函数内调用GetQueuedCompletionStatus函数
//在AcceptEx操做完成后，将已接收的客户机套接字和完成端口关联起来
...

本段代码演示如何加载AcceptEx函数。

同时注意到，由于AcceptEx的高性能特性，监听套接字的套接字属性不会自动被客户机套接字继承，要继承属性，服务器必须用SO_UPDATE_ACCEPT_CONTEXT及客户机套接字句柄调用setsockopt。

另一点要清楚，若是为AcceptEx指定了一个接收缓冲区，则重叠操做只有在链接上收到至少一个字节的数据以后才能完成。