функция обратного вызова PFN_WSK_ABORT_EVENT (wsk.h)

Статья
02/07/2025

Функция обратного вызова событий WskAbortEvent уведомляет приложение WSK о том, что входящие запросы на подключение к сокету прослушивания с включенным режимом условного принятия были удалены.

Синтаксис

PFN_WSK_ABORT_EVENT PfnWskAbortEvent;

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

Параметры

[in, optional] SocketContext

Указатель на контекст сокета для прослушивающего сокета, по которому был получен входящий запрос на подключение. Приложение WSK предоставило этот указатель на подсистему WSK при вызове функции WskSocket для создания сокета прослушивания.

[in] InspectID

Указатель на структуру WSK_INSPECT_ID. Содержимое структуры определяет входящий запрос на подключение, который был удален.

Возвращаемое значение

Функция обратного вызова событий WSK приложения WSK должна всегда возвращать STATUS_SUCCESS.

Замечания

Подсистема WSK вызывает функцию обратного вызова событий WSK приложения WSK WskAbortEvent, только если выполняются следующие условия:

Приложение WSK создало сокет прослушивания с включенным условным режимом приема.
Входящий запрос на подключение был получен в сокет прослушивания, а подсистема WSK вызвала функции обратного вызова событий WSK приложения WskInspectEvent.
Приложение WSK вернуло WskInspectPend или WskInspectAccept из функции обратного вызова событий WskAbortEvent для входящего запроса подключения.
Входящие запросы на подключение были удалены локально или удаленно до полной установки.

Когда подсистема WSK вызывает функцию обратного вызова событий WSK приложения WSK WskAbortEvent, приложение должно завершить проверку для входящего запроса на подключение. Запрос на подключение определяется содержимым структуры WSK_INSPECT_ID, на которую указывает параметр InspectID.

Если приложение WSK вызывает функцию WskInspectComplete для входящего запроса на подключение, которое было прервано, подключение не будет установлено, даже если WskInspectAccept указан в параметре Action.

Приложение WSK может включить режим условного принятия в сокете прослушивания, включив параметр SO_CONDITIONAL_ACCEPT сокета. Дополнительные сведения об условном принятии входящих подключений см. в прослушивании и принятии входящих подключений.

Подсистема WSK вызывает функцию обратного вызова событий WSK приложения WSK WskAbortEvent в IRQL <= DISPATCH_LEVEL.

Функция обратного вызова событий приложения WSK WskAbortEvent не должна ждать завершения других запросов WSK в контексте функций завершения WSK или обратного вызова событий. Обратный вызов может инициировать другие запросы WSK (если он не тратит слишком много времени на DISPATCH_LEVEL), но он не должен ждать завершения даже при вызове обратного вызова в IRQL = PASSIVE_LEVEL.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
целевая платформа	Виндоус
заголовка	wsk.h (include Wsk.h)
IRQL	<= DISPATCH_LEVEL