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

另請參閱

• OVERLAPPED_ENTRY
• ProcessSocketNotifications
• Winsock 套接字狀態通知