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

Статья
08/08/2023

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

Синтаксис

PFN_WSK_DISCONNECT_EVENT PfnWskDisconnectEvent;

NTSTATUS PfnWskDisconnectEvent(
  [in, optional] PVOID SocketContext,
  [in]           ULONG Flags
)
{...}

Параметры

[in, optional] SocketContext

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

Он вызвал функцию WskSocket для создания сокета.
Он вызвал функцию WskSocketConnect для создания сокета.
Она вызвала функцию WskAccept для принятия сокета в качестве входящего подключения.
Его функция обратного вызова события WskAcceptEvent была вызвана для принятия сокета в качестве входящего подключения.

[in] Flags

Значение ULONG, содержащее побитовое или сочетание следующих флагов:

WSK_FLAG_ABORTIVE

Удаленное приложение выполнило прерывание отключения сокета. Если этот флаг не установлен, удаленное приложение выполнило корректное отключение сокета.

WSK_FLAG_AT_DISPATCH_LEVEL

Подсистема WSK называется функцией обратного вызова событий WskDisconnectEvent в IRQL = DISPATCH_LEVEL. Если этот флаг не задан, подсистема WSK могла вызвать функцию обратного вызова события WskDisconnectEvent при любом irQL <= DISPATCH_LEVEL.

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

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

Подсистема WSK вызывает функцию обратного вызова событий WSK-приложения WSKDisconnectEvent , когда сокет, ориентированный на подключение, отключен удаленным приложением, только если функция обратного вызова события была ранее включена с параметром сокета SO_WSK_EVENT_CALLBACK . Дополнительные сведения о включении функций обратного вызова событий сокета см. в разделе Включение и отключение функций обратного вызова событий.

Если удаленное приложение выполнило корректное отключение сокета, дальнейшие данные из сокета не будут получены. Однако приложение WSK по-прежнему может отправлять данные в сокет, пока сокет не будет полностью закрыт удаленным приложением или приложение WSK не вызовет функцию WskDisconnect или функцию WskCloseSocket в сокете.

Если удаленное приложение выполнило прерывание отключения сокета, дальнейшие данные из сокета не будут получены, и никакие другие данные не могут быть отправлены в сокет.

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

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

Требования

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