PFN_WSK_ABORT_EVENT回呼函式 (wsk.h)

發行項
03/01/2024

WskAbortEvent 事件回呼函式會通知 WSK 應用程式已卸除已啟用條件式接受模式之接聽套接字上的連入連線要求。

語法

PFN_WSK_ABORT_EVENT PfnWskAbortEvent;

NTSTATUS PfnWskAbortEvent(
  [in, optional] PVOID SocketContext,
  [in]           PWSK_INSPECT_ID InspectID
)
{...}

參數

[in, optional] SocketContext

接收連入連線要求之接聽套接字內容的指標。當 WSkSocket 函式呼叫 WskSocket 函式以建立接聽套接字時，WSK 應用程式會提供此指標給 WSK 子系統。

[in] InspectID

WSK_INSPECT_ID 結構的指標。結構的內容會識別已卸除的連入連線要求。

傳回值

WSK 應用程式的 WskAbortEvent 事件回呼函式必須一律傳回STATUS_SUCCESS。

備註

只有在下列條件成立時，WSK 子系統才會呼叫 WSK 應用程式的 WskAbortEvent 事件回呼函式：

WSK 應用程式已建立已啟用條件式接受模式的接聽套接字。
接聽套接字上已收到連入連線要求，而 WSK 子系統已呼叫 WSK 應用程式的 WskInspectEvent 事件回呼函式。
WSK 應用程式從傳入連線要求的 WskAbortEvent 事件回呼函式傳回 WskInspectPend 或 WskInspectAccept。
在完全建立之前，傳入連線要求已在本機或遠端卸除。

當 WSK 子系統呼叫 WSK 應用程式的 WskAbortEvent 事件回呼函式時，應用程式應該終止對連入連線要求的檢查。連接要求是由 InspectID 參數所指向之WSK_INSPECT_ID結構的內容所識別。

如果 WSK 應用程式在已中止的連入連線要求上呼叫 WskInspectComplete 函式，即使在 Action 參數中指定 WskInspectAccept，也不會建立連線。

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

WSK 子系統會在 IRQL <= DISPATCH_LEVEL 呼叫 WSK 應用程式的 WskAbortEvent 事件回呼函式。

WSK 應用程式的 WskAbortEvent 事件回呼函式不得等候 WSK 完成或事件回呼函式內容中的其他 WSK 要求完成。回呼可以起始其他 WSK 要求， (假設它不會花費太多時間在DISPATCH_LEVEL) ，但即使呼叫 IRQL = PASSIVE_LEVEL的回呼，也必須等到完成。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	Windows
標頭	wsk.h (包含 Wsk.h)
IRQL	<= DISPATCH_LEVEL