WSAWaitForMultipleEvents() .

简述：只要指定事件对象中的一个或全部处于有信号状态，或者超时间隔到，则返回。

　　#include <winsock2.h>

　　DWORD WSAAPI WSAWaitForMultipleEvents( DWORD

　　cEvents,

　　const WSAEVENT FAR * lphEvents, BOOL fWaitAll,

　　DWORD dwTimeout,

　　BOOL fAlertable );

　　cEvents：指出lphEvents所指数组中事件对象句柄的数目。事件对象句柄的最大值为WSA_MAXIMUM_WAIT_EVENTS。

　　lphEvents：指向一个事件对象句柄数组的指针。

　　fWaitAll：指定等待类型。若为真TRUE，则当lphEvents数组中的所有事件对象同时有信号时，函数返回。若为假FALSE，则当任意一个事件对象有信号时函数即返回。在后一种情况下，返回值指出是哪一个事件对象造成函数返回。

　　dwTimeout：指定超时时间间隔（以毫秒计）。当超时间隔到，函数即返回，不论fWaitAll参数所指定的条件是否满足。如果dwTimeout为零，则函数测试指定的时间对象的状态，并立即返回。如果dwTimeout是WSA_INFINITE，则函数的超时间隔永远不会到。

　　fAlertable：指定当系统将一个输入/输出完成例程放入队列以供执行时，函数是否返回。若为真TRUE，则函数返回且执行完成例程。若为假FALSE，函数不返回，不执行完成例程。请注意在Win16中忽略该参数。

　　返回值：

　　如果函数成功，返回值指出造成函数返回的事件对象。

　　如果函数失败，返回值为WSA_WAIT_FAILED。可调用WSAGetLastError()来获取进一步的错误信息。

　　错误代码：

　　WSANOTINITIALISED                在调用本API之前应成功调用WSAStartup()。

　　WSAENETDOWN                        网络子系统失效。

　　WSA_NOT_ENOUGH_MEMORY        无足够内存完成该操作。

　　WSA_INVALID_HANDLE         lphEvents数组中的一个或多个值不是合法的事件对象句柄。

　　WSA_INVALID_PARAMETER                cEvents参数未包含合法的句柄数目。