Функция SocketNotificationRetrieveEvents (winsock2.h)
Эта встроенная вспомогательная функция предоставляется для удобства получения маски событий из OVERLAPPED_ENTRY.
Дополнительные сведения и примеры кода см. в разделе Уведомления о состоянии сокета Winsock.
Синтаксис
UINT32 SocketNotificationRetrieveEvents(
OVERLAPPED_ENTRY *notification
);
Параметры
notification
Тип: _In_ OVERLAPPED_ENTRY*
Указатель на OVERLAPPED_ENTRY получено для уведомления о состоянии сокета.
Возвращаемое значение
Объект UINT32, содержащий битовую маску событий уведомлений для сокета.
В этой таблице перечислены события уведомлений сокета. Это события, возможные при получении уведомления.
| Событие | Описание |
|---|---|
| SOCK_NOTIFY_EVENT_IN | Входные данные доступны из сокета без блокировки. |
| SOCK_NOTIFY_EVENT_OUT | Выходные данные можно предоставить в сокет без блокировки. |
| SOCK_NOTIFY_EVENT_HANGUP | Подключение к сокету прервано. |
| SOCK_NOTIFY_EVENT_ERR | Сокет находится в состоянии ошибки. |
| SOCK_NOTIFY_EVENT_REMOVE | Уведомление было отменено. |
Комментарии
События SOCK_NOTIFY_EVENT_ERR и SOCK_NOTIFY_EVENT_REMOVE могут быть указаны независимо от зарегистрированного фильтра событий.
Если указано событие SOCK_NOTIFY_EVENT_REMOVE , уведомления больше не будут предоставляться.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | сборка Windows 10 20348 |
| Минимальная версия сервера | сборка Windows 10 20348 |
| Верхняя часть | winsock2.h |
| Библиотека | Ws2_32.lib |
| DLL | Ws2_32.dll |