WSAEnumNetworkEvents()

简述：检测所指定的套接口上网络事件的发生。

#include <winsock2.h>

int WSAAPI WSAEnumNetworkEvents ( SOCKET s,

WSAEVENT hEventObject, LPWSANETWORKEVENTS

lpNetworkEvents, LPINT lpiCount);

s：标识套接口的描述字。

hEventObject：（可选）句柄，用于标识需要复位的相应事件对象。

lpNetworkEvents：一个WSANETWORKEVENTS结构的数组，每一个元素记录了一个网络事件和相应的错误代码。

lpiCount：数组中的元素数目。在返回时，本参数表示数组中的实际元素数目；如果返回值是WSAENOBUFS，则表示为获取所有网络事件所需的元素数目。

返回值：

如果操作成功则返回0。否则的话，将返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()来获取相应的错误代码。

错误代码：

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

WSAENETDOWN 网络子系统失效。

WSAEINVAL 参数中有非法值。

WSAEINPROGRESS 一个阻塞的WinSock调用正在进行中，或者服务提供者仍在处理一个回调函数WSAENOBUFS 所提供的缓冲区太小。

_________________________

typedef struct _WSANETWORKEVENTS {  long lNetworkEvents;  int  iErrorCode[FD_MAX_EVENTS];} WSANETWORKEVENTS, *LPWSANETWORKEVENTS;

lNetworkEvents

表示该FD_XXX网络事件时有发生。

iErrorCode中

阵列，其中包含的任何相关联的错误代码，用对应于在事件的比特位置的数组索引lNetworkEvents。标识符FD_READ_BIT，FD_WRITE_BIT和其他可被用于索引iErrorCode中数组。