Функция WSAResetEvent (winsock2.h)

Статья
08/27/2023

Функция WSAResetEvent сбрасывает состояние указанного объекта события на незначаемое.

Синтаксис

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

Параметры

[in] hEvent

Дескриптор, определяющий открытый дескриптор объекта события.

Возвращаемое значение

Если функция WSAResetEvent завершается успешно, возвращается значение TRUE. Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите WSAGetLastError.

Код ошибки	Значение
WSANOTINITIALISED	Перед использованием этой функции должен быть выполнен успешный вызов WSAStartup .
WSAENETDOWN	Произошел сбой сетевой подсистемы.
WSAEINPROGRESS	Выполняется блокирующий вызов Windows Sockets 1.1 или поставщик услуг по-прежнему обрабатывает функцию обратного вызова.
WSA_INVALID_HANDLE	Параметр hEvent не является допустимым дескриптором объекта события.

Правильный способ сброса состояния объекта события, используемого с функцией WSAEventSelect , заключается в передаче дескриптора объекта события в функцию WSAEnumNetworkEvents в параметре hEventObject . Это приведет к сбросу объекта события и настройке состояния активных событий FD в сокете атомарным образом.

Windows Phone 8. Эта функция поддерживается для приложений Магазина Windows Phone Windows Phone 8 и более поздних версий.

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
Header	winsock2.h
Библиотека	Ws2_32.lib
DLL	Ws2_32.dll