WSAResetEvent 函式 (winsock2.h)
WSAResetEvent函式會將指定事件物件的狀態重設為非ignaled。
語法
BOOL WSAAPI WSAResetEvent(
[in] WSAEVENT hEvent
);
參數
[in] hEvent
識別開啟事件物件控制碼的控制碼。
傳回值
如果 WSAResetEvent 函式成功,則傳回值為 TRUE。 如果函式失敗,則傳回值為 FALSE。 若要取得擴充錯誤資訊,請呼叫 WSAGetLastError。
錯誤碼 | 意義 |
---|---|
使用此函式之前,必須先進行成功的 WSAStartup 呼叫。 | |
網路子系統失敗。 | |
封鎖的 Windows Sockets 1.1 呼叫正在進行中,或者服務提供者仍在處理回呼函式。 | |
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 |