Windows Sockets 2扩展库函数简要参考(十二)

2010-12-30 21:01:20 · 作者: · 浏览: 31729

7.6 WSAEnumNetworkEvents()

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

 

          #include <winsock2.h>

 

          int WSAAPI WSAEnumNetworkEvents ( SOCKET s,

          WSAEVENT hEventObject, LPWSANETWORKEVENTS

          lpNetworkEvents,  LPINT lpiCount);

 

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

hEventObject:(可选)句柄,用于标识需要复位的相应事件对象。

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

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

 

返回值:

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

 

错误代码:

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

WSAENETDOWN