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

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

  • Статья

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

Синтаксис

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

Параметры

[in] serviceHost

Указатель на открываемый объект Узла службы . Указатель должен ссылаться на допустимый объект WS_SERVICE_HOST , возвращаемый WsCreateServiceHost , а указанное значение узла службы может не иметь значения NULL.

[in, optional] asyncContext

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

[in, optional] error

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

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

Эта функция может возвращать одно из этих значений.

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

Комментарии

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

Требования

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