WSAResetEvent 函式 (winsock2.h)

WSAResetEvent函式會將指定事件物件的狀態重設為非ignaled。

語法

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

[in] hEvent

識別開啟事件物件控制碼的控制碼。

如果 WSAResetEvent 函式成功，則傳回值為 TRUE。如果函式失敗，則傳回值為 FALSE。若要取得擴充錯誤資訊，請呼叫 WSAGetLastError。

錯誤碼	意義
WSANOTINITIALISED	使用此函式之前，必須先進行成功的 WSAStartup 呼叫。
WSAENETDOWN	網路子系統失敗。
WSAEINPROGRESS	封鎖的 Windows Sockets 1.1 呼叫正在進行中，或者服務提供者仍在處理回呼函式。
WSA_INVALID_HANDLE	hEvent參數不是有效的事件物件控制碼。

WSAResetEvent函式可用來將事件物件的狀態設定為非ignaled。

重設與WSAEventSelect函式搭配使用之事件物件狀態的適當方式，就是將事件物件的控制碼傳遞至hEventObject參數中的WSAEnumNetworkEvents函式。這會重設事件物件，並以不可部分完成的方式調整通訊端上作用中 FD 事件的狀態。

Windows Phone 8：Windows Phone 8 和更新版本Windows Phone市集應用程式支援此函式。

Windows 8.1和Windows Server 2012 R2：Windows 市集應用程式支援此功能，Windows 8.1、Windows Server 2012 R2 及更新版本。


最低支援的用戶端	Windows 8.1、Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	winsock2.h
程式庫	Ws2_32.lib
Dll	Ws2_32.dll