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 |