WSK_INSPECT_ID 结构 (wsk.h)

项目
03/05/2024

WSK_INSPECT_ID结构指定侦听套接字上的传入连接请求的标识符。

语法

typedef struct _WSK_INSPECT_ID {
  ULONG_PTR Key;
  ULONG     SerialNumber;
} WSK_INSPECT_ID, *PWSK_INSPECT_ID;

成员

Key

分配给传入连接请求的密钥。

SerialNumber

分配给传入连接请求的序列号。

注解

只要传入的连接请求到达启用了条件接受模式的侦听套接字，WSK 子系统就会将指向WSK_INSPECT_ID结构的指针传递给 WSK 应用程序的 WskInspectEvent 事件回调函数。 WSK_INSPECT_ID 结构的内容唯一标识传入的连接请求。

如果 WSK 应用程序从对其 WskInspectEvent 事件回调函数的调用返回 WskInspectPend ，则应用程序必须首先将 WSK 子系统提供的 WSK_INSPECT_ID 结构的内容复制到其自己的 WSK_INSPECT_ID 结构中。然后，WSK 应用程序在完成检查时将指向其WSK_INSPECT_ID结构的指针传递给 WskInspectComplete 函数。

如果在检查操作挂起时远程系统删除传入的连接请求，则 WSK 子系统使用指向标识已删除请求的WSK_INSPECT_ID结构的指针调用 WSK 应用程序的 WskAbortEvent 事件回调函数。 WSK 应用程序使用此WSK_INSPECT_ID结构的内容来确定应终止对传入连接请求的检查。 WSK 应用程序应将WSK_INSPECT_ID结构的内容与匹配项检查进行比较。结构成员的实际值无关紧要。

WSK 应用程序可以通过启用 SO_CONDITIONAL_ACCEPT 套接字选项在侦听套接字上启用条件接受模式。有关有条件地接受传入连接的详细信息，请参阅侦听和接受传入Connections。