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

Статья
03/04/2024

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

Синтаксис

BOOL WSAAPI WSACloseEvent(
  [in] WSAEVENT hEvent
);

Параметры

[in] hEvent

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

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

Если функция выполнена успешно, возвращается значение TRUE.

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

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

Функция WSACloseEvent закрывает дескриптор для объекта события и освобождает ресурсы, связанные с объектом события. Эта функция используется для закрытия дескриптора, созданного функцией WSACreateEvent . После закрытия дескриптора объекта события дальнейшие ссылки на этот дескриптор будут завершаться ошибкой WSA_INVALID_HANDLE.

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