Функция WsAbortListener (webservices.h)

Отменяет все ожидающие операции ввода-вывода для указанного прослушивателя.

Синтаксис

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Параметры

[in] listener

Указатель на структуру WS_LISTENER , представляющую прослушиватель, для которого требуется отменить ввод-вывод.

[in, optional] error

Указатель на структуру WS_ERROR , которая получает дополнительные сведения об ошибке в случае сбоя функции.

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

Если функция завершается успешно, она возвращает NO_ERROR; в противном случае возвращается код ошибки HRESULT.

Комментарии

WsAbortListener можно вызывать, когда прослушиватель находится в любом состоянии. (Возможные состояния см. в перечислении WS_LISTENER_STATE .) Если прослушиватель находится в состоянии WS_LISTENER_STATE_OPEN, эта функция приведет к сбою прослушивателя (сброс в состояние WS_LISTENER_STATE_FAULTED). При сбое прослушивателя все попытки принять сообщение от него немедленно завершаются ошибкой с кодом WS_E_OBJECT_FAULTED.

Эта функция не ожидает завершения ожидающих операций ввода-вывода.

При вызове с допустимыми параметрами эта функция не завершится ошибкой по таким причинам, как отсутствие системных ресурсов.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	webservices.h
Библиотека	WebServices.lib
DLL	WebServices.dll