分享

WSAWaitForMultipleEvents()

 vcand3d 2013-01-26

 

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中忽略该参数。

----------------

WSAWaitForMultipleEvents() - 返回值

 如果函数成功,返回值指出造成函数返回的事件对象
  如果函数失败,返回值为WSA_WAIT_FAILED。可调用WSAGetLastError()来获取进一步的错误信息。

错误代码:
WSANOTINITIALISED                在调用本API之前应成功调用WSAStartup()。
WSAENETDOWN                        网络子系统失效。
WSA_NOT_ENOUGH_MEMORY        无足够内存完成该操作。
WSA_INVALID_HANDLE         lphEvents数组中的一个或多个值不是合法的事件对象句柄。
WSA_INVALID_PARAMETER                cEvents参数未包含合法的句柄数目。

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多