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
Library	Ws2_32.lib
DLL	Ws2_32.dll

另请参阅

• OVERLAPPED_ENTRY
• ProcessSocketNotifications
• Winsock 套接字状态通知