Поделиться через

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

  • Статья

Приводит к прекращению прослушивания указанного прослушивателя .

Синтаксис

HRESULT WsCloseListener(
  [in]           WS_LISTENER            *listener,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Параметры

[in] listener

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

[in, optional] asyncContext

Указатель на WS_ASYNC_CONTEXT структуру, содержащую сведения для асинхронного вызова функции. Передайте значение NULL для синхронного вызова функции.

[in, optional] error

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

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

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

Код возврата Описание
WS_S_ASYNC
 Асинхронная операция по-прежнему находится в состоянии ожидания.
WS_E_OPERATION_ABORTED
 Закрытие было прервано вызовом WsAbortListener , так как прослушиватель закрывался.
WS_E_INVALID_OPERATION
 Прослушиватель находился в неподходяющем состоянии.
WS_E_OPERATION_TIMED_OUT
 Операция не была завершена в отведенное время.
E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
Другие ошибки
Эта функция может возвращать другие ошибки, не перечисленные выше.

Комментарии

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

Эта операция разрешена прослушивателю в состоянии WS_LISTENER_STATE_OPEN или WS_LISTENER_STATE_FAULTED . (Сведения о состояниях прослушивателя см. в перечислении WS_LISTENER_STATE .)

При закрытии прослушивателя все ожидающие попытки принять канал с помощью метода WsAcceptChannel прерываются. Однако WsCloseListener ожидает завершения любого ожидающего ввода-вывода, прежде чем продолжить процесс закрытия.

Требования

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