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

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

  • Статья

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

Синтаксис

HRESULT WsAbandonCall(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in]           ULONG            callId,
  [in, optional] WS_ERROR         *error
);

Параметры

[in] serviceProxy

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

[in] callId

Идентификатор прерванного вызова. (См. раздел примeчаний.)

[in, optional] error

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

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

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

Код возврата Описание
WS_E_INVALID_OPERATION
 Текущее состояние прокси-сервера службы недопустимо для этой операции.
E_INVALIDARG
 В функцию был передан прокси-сервер службы NULL .

Комментарии

Вызовы идентифицируются по идентификатору вызова. Этот идентификатор вызова связан с вызовом WS_CALL_PROPERTY_CALL_ID значением перечисления WS_CALL_PROPERTY_ID .

Если идентификатор вызова равен 0, все ожидающие вызовы на прокси-сервере службы будут прерваны. Дополнительные сведения см. в следующих разделах:

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

Это приводит к усложняющимся потреблением ресурсов, если приложение продолжает отказываться от вызовов, как это может произойти, когда сервер медленно отвечает клиенту, а клиентское приложение отказывается только от одного вызова, чтобы повторить тот же вызов.

Требования

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