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

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

  • Статья

Прерывает работу прокси-сервера службы и отменяет все ожидающие операции ввода-вывода на прокси-сервере службы.

Синтаксис

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

Параметры

[in] serviceProxy

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

[in, optional] error

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

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

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

Код возврата Описание
E_INVALIDARG
 Один или несколько аргументов недопустимы.

Комментарии

WsAbortServiceProxy показывает следующее поведение в зависимости от состояния прокси-сервера службы (см. перечисление WS_SERVICE_PROXY_STATE возможных состояний):

  • Если прокси-сервер службы открывается и находится в состоянии WS_SERVICE_PROXY_STATE_OPENING, можно вызвать WsAbortServiceProxy , чтобы прервать операцию открытия. Прокси-сервер службы отменит все ожидающие операции ввода-вывода и снова перейдет в состояние WS_SERVICE_PROXY_STATE_CREATED.
  • Если прокси-сервер службы уже открыт и находится в состоянии WS_SERVICE_PROXY_STATE_OPEN, WsAbortServiceProxy приведет к прерыванию прокси-сервера службы всех базовых каналов и переходу в состояние WS_SERVICE_PROXY_STATE_FAULTED. После инициации прерывания прокси-сервер службы не будет принимать новые вызовы. Приложение может вызвать WsCloseServiceProxy , чтобы закрыть его
  • Если прокси-сервер службы закрывается и находится в состоянии WS_SERVICE_PROXY_STATE_CLOSING, все базовые каналы прерываются, а прокси-сервер службы переходит в состояние WS_SERVICE_PROXY_STATE_CLOSED.

Пример использования этой функции см. в разделе ServiceCancellationExample.

Требования

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