PFN_WSK_DISCONNECT回调函数（wsk.h）

项目
02/07/2025

WskDisconnect 函数断开了面向连接的套接字或流套接字与远程传输地址的连接。

语法

PFN_WSK_DISCONNECT PfnWskDisconnect;

NTSTATUS PfnWskDisconnect(
  [in]           PWSK_SOCKET Socket,
  [in, optional] PWSK_BUF Buffer,
  [in]           ULONG Flags,
  [in, out]      PIRP Irp
)
{...}

参数

[in] Socket

指向 WSK_SOCKET 结构的指针，该结构指定正在断开连接的套接字的套接字对象。

[in, optional] Buffer

指向 WSK_BUF 结构的指针。此结构描述一个数据缓冲区，该缓冲区包含 WSK 子系统在断开连接之前要传输到远程传输地址的数据。如果没有此类数据要传输，WSK 应用程序会将此指针设置为 NULL。如果在标志参数中指定了WSK_FLAG_ABORTIVE，Buffer 参数必须 NULL。

[in] Flags

包含以下标志或零的 ULONG 值：

WSK_FLAG_ABORTIVE

指示 WSK 子系统执行套接字的中止断开连接。如果 WSK 应用程序未指定此标志，则 WSK 子系统将执行套接字的正常断开连接。

[in, out] Irp

指向 WSK 子系统用于异步完成断开连接作的调用方分配的 IRP 的指针。有关将 IRP 与 WSK 函数配合使用的详细信息，请参阅将 IRP 与 Winsock 内核函数配合使用。

返回值

WskDisconnect 返回以下 NTSTATUS 代码之一：

返回代码	描述
STATUS_SUCCESS	套接字已成功与远程传输地址断开连接。 IRP 将以成功状态完成。
STATUS_PENDING	WSK 子系统无法立即断开套接字的连接。 WSK 子系统在断开套接字与远程传输地址的连接后，将完成 IRP。断开连接作的状态将在 IRP 的 IoStatus.Status 字段中返回。
STATUS_FILE_FORCED_CLOSED	套接字不再正常工作。 IRP 将以失败状态完成。 WSK 应用程序必须调用 WskCloseSocket 函数才能尽快关闭套接字。
其他状态代码	发生错误。 IRP 将以失败状态完成。

言论

WSK 应用程序只能调用 WskDisconnect 函数，该函数仅适用于以前连接到远程传输地址或它接受在侦听套接字上的套接字上的流套接字。

WskDisconnect 会导致 WSK 子系统通过适合基础传输的任何方式通知远程传输地址，即连接正在断开连接。如果 Buffer 参数为非NULL，则 WSK 子系统在断开套接字连接之前，会将缓冲区中的数据传输到远程传输地址。

如果执行正常断开连接，WSK 子系统会等待所有未完成的传输数据在断开套接字之前发送。套接字断开连接后，WSK 应用程序无法将任何其他数据发送到远程传输地址。但是，WSK 应用程序仍可以从远程传输地址接收其他数据，直到远程应用程序断开其套接字末尾的连接。

请注意，并非所有传输都支持半开放连接。如果传输不支持半打开的连接，则执行正常断开连接后，WSK 应用程序将不会从远程传输地址接收任何其他数据。

正常断开连接后，仅当传输协议完全完成断开连接作时，IRP 才会完成。对于某些传输协议，如果向远程传输地址传输数据时遇到问题，IRP 可能无法完成。在这种情况下，WSK 应用程序可以通过再次调用 WskDisconnect 函数并指定WSK_FLAG_ABORTIVE标志或调用 WskCloseSocket 函数来恢复。在任一情况下，WSK 子系统都会中止断开套接字的连接，并强制完成挂起的 IRP。

如果执行中止断开连接，WSK 子系统将取消所有正在进行的和挂起的传输作，并且不会等待断开套接字的连接。断开连接后，WSK 应用程序无法将任何其他数据发送到远程传输地址，也无法从远程传输地址接收任何其他数据。

WSK 应用程序可以通过调用 WskCloseSocket 函数完全关闭连接。

要求

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