WSAEnumNetworkEvents()

WSAEnumNetworkEvents()是一種檢測所指定的套接口上網路事件發生的命令。

基本介紹

• 外文名：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 所提供的緩衝區太小。

另請參閱： WSAEventSelect()