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

Статья
08/27/2023

Функция WSACreateEvent создает новый объект события.

Синтаксис

WSAEVENT WSAAPI WSACreateEvent();

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

Если ошибка не возникает, WSACreateEvent возвращает дескриптор объекта события. В противном случае возвращаемое значение будет WSA_INVALID_EVENT. Чтобы получить расширенные сведения об ошибке, вызовите WSAGetLastError.

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

Функция WSACreateEvent создает объект события сброса вручную с начальным состоянием nonsignaled. Дескриптор возвращаемого объекта события не может быть унаследован дочерними процессами. Объект события неименован.

Функцию WSASetEvent можно вызвать, чтобы задать состояние объекта события как signaled. Функцию WSAResetEvent можно вызвать, чтобы задать для объекта события состояние nonsignaled. Если объект события больше не нужен, необходимо вызвать функцию WSACloseEvent , чтобы освободить ресурсы, связанные с объектом события.

Объекты событий Windows Sockets 2 — это системные объекты в средах Windows. Таким образом, если приложение Windows хочет использовать событие автоматического сброса, а не событие сброса вручную, приложение может вызвать функцию CreateEvent напрямую. Область объекта события ограничивается процессом, в котором он создается.

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