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

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

  • Статья

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

Синтаксис

HRESULT WsCloseServiceProxy(
  [in]           WS_SERVICE_PROXY       *serviceProxy,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Параметры

[in] serviceProxy

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

[in, optional] asyncContext

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

[in, optional] error

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

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

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

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

Комментарии

Если вызов операции службы находится в ожидании на прокси-сервере службы, WsCloseServiceProxy ожидает завершения каждого вызова. После вызова WsCloseServiceProxy приложение не должно выполнять больше вызовов на прокси-сервере службы.

Обратите внимание, что WS_E_INVALID_OPERATION является единственным
код ошибки, указывающий на сбой закрытия. Другие коды ошибок указывают на то, что операция выполнена успешно, а код ошибки предназначен только для информационных целей.

Требования

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