WSK_INSPECT_ID结构 (wsk.h)

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 套接字选项在侦听套接字上启用条件接受模式。 有关有条件地接受传入连接的详细信息,请参阅 侦听和接受传入连接

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
标头 wsk.h (包括 Wsk.h)

另请参阅

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent