Поделиться через


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

Функция 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 не является допустимым дескриптором объекта события.

Комментарии

Функция WSAResetEvent используется для установки состояния объекта события в состояние без знака.

Правильный способ сброса состояния объекта события, используемого с функцией 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

См. также раздел

WSACloseEvent

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSASetEvent

Функции Winsock

Справочник по Winsock