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

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

  • Статья

Закрывает связь с указанным узлом службы.

Синтаксис

HRESULT WsCloseServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Параметры

[in] serviceHost

Указатель на структуру WS_SERVICE_HOST , представляющую закрываемую службу.

[in, optional] asyncContext

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

[in, optional] error

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

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

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

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

Комментарии

WsCloseServiceHost закрывает все прослушиватели на узле службы. В результате новые каналы от клиента не принимаются. Однако выполнение ожидающих операций ввода-вывода в уже принятых каналах разрешено.

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

Требования

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