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 應用程式的 WskAbortEvent 事件回呼函式，其中包含識別已卸除要求之WSK_INSPECT_ID結構的指標。 WSK 應用程式會使用此WSK_INSPECT_ID結構的內容來判斷應該終止傳入連線要求的檢查。 WSK 應用程式應該比較WSK_INSPECT_ID結構的內容，以檢查相符專案。結構成員的實際值無關。

WSK 應用程式可以啟用接聽套接字的條件式接受模式，方法是啟用 SO_CONDITIONAL_ACCEPT 套接字選項。如需條件式接受連入連線的詳細資訊，請參閱接聽和接受傳入 Connections。