PFN_WSK_DISCONNECT_EVENT回调函数 (wsk.h)

项目
08/08/2023

WskDisconnectEvent 事件回调函数通知 WSK 应用程序，远程应用程序已断开面向连接的套接字上的连接。

语法

PFN_WSK_DISCONNECT_EVENT PfnWskDisconnectEvent;

NTSTATUS PfnWskDisconnectEvent(
  [in, optional] PVOID SocketContext,
  [in]           ULONG Flags
)
{...}

参数

[in, optional] SocketContext

指向已断开连接的面向连接的套接字的套接字上下文的指针。 WSK 应用程序通过以下方式之一提供了指向 WSK 子系统的指针：

它调用 WskSocket 函数来创建套接字。
它调用 WskSocketConnect 函数来创建套接字。
它调用 WskAccept 函数以接受套接字作为传入连接。
调用其 WskAcceptEvent 事件回调函数以接受套接字作为传入连接。

[in] Flags

一个 ULONG 值，该值包含以下标志的组合的按位 OR：

WSK_FLAG_ABORTIVE

远程应用程序执行了套接字的中止断开连接。如果未设置此标志，远程应用程序将正常断开套接字。

WSK_FLAG_AT_DISPATCH_LEVEL

WSK 子系统在 IRQL = DISPATCH_LEVEL调用 WskDisconnectEvent 事件回调函数。如果未设置此标志，则 WSK 子系统可能在任何 IRQL <= DISPATCH_LEVEL调用了 WskDisconnectEvent 事件回调函数。

返回值

WSK 应用程序的 WskDisconnectEvent 事件回调函数必须始终返回STATUS_SUCCESS。

注解

仅当远程应用程序断开面向连接的套接字时，WSK 子系统才调用 WSK 应用程序的 WskDisconnectEvent 事件回调函数，前提是事件回调函数以前是使用 SO_WSK_EVENT_CALLBACK 套接字选项启用的。有关启用套接字的事件回调函数的详细信息，请参阅启用和禁用事件回调函数。

如果远程应用程序正常断开了套接字，则不会从套接字收到进一步的数据。但是，WSK 应用程序仍可以将数据发送到套接字，直到套接字被远程应用程序完全关闭，或者 WSK 应用程序调用套接字上的 WskDisconnect 函数或 WskCloseSocket 函数。

如果远程应用程序执行了套接字的中止断开连接，则不会从套接字接收进一步的数据，也不能将进一步的数据发送到套接字。

WSK 子系统在 IRQL <= DISPATCH_LEVEL调用 WSK 应用程序的 WskDisconnectEvent 事件回调函数。

WSK 应用程序的 WskDisconnectEvent 事件回调函数不得等待 WSK 完成或事件回调函数上下文中的其他 WSK 请求完成。回叫可以启动其他 WSK 请求 (假定它不会在DISPATCH_LEVEL) 花费太多时间，但即使回调在 IRQL = PASSIVE_LEVEL 调用，也不得等待其完成。

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台	Windows
标头	wsk.h (包括 Wsk.h)
IRQL	<= DISPATCH_LEVEL