PFN_WSK_CONNECT回调函数（wsk.h）

项目
02/07/2025

WskConnect 函数将面向连接或流套接字连接到远程传输地址。

语法

PFN_WSK_CONNECT PfnWskConnect;

NTSTATUS PfnWskConnect(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR RemoteAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

参数

[in] Socket

指向 WSK_SOCKET 结构的指针，该结构指定连接到远程传输地址的套接字的套接字对象。

[in] RemoteAddress

指向一个结构的指针，该结构指定要连接到套接字的远程传输地址。此指针必须是指向特定 SOCKADDR 结构类型的指针，该类型对应于创建套接字时指定的 WSK 应用程序指定的地址系列。

Flags

此参数保留供系统使用。 WSK 应用程序必须将此参数设置为零。

[in, out] Irp

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

返回值

WskConnect 返回以下 NTSTATUS 代码之一：

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

言论

WSK 应用程序只能通过调用 WskBind 函数，在应用程序以前绑定到本地传输地址的连接或流套接字上调用 WskConnect 函数。

对于流套接字，WskConnect 成功在流套接字上调用后，该套接字将提交到面向连接的流，并且可能不再调用侦听套接字函数。

WSK 应用程序可以通过调用 WskSocketConnect 函数，而不是调用 WskSocket 函数、WskBind 函数，以及 WskConnect 函数，在单个函数调用中创建、绑定和连接面向连接的套接字。建议调用 WskSocketConnect 函数，除非 WSK 应用程序需要在绑定或连接套接字之前设置套接字选项或发出 I/O 控制作。

要求

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