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

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

  • Статья

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

Синтаксис

HRESULT WsAbortChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

Параметры

[in] channel

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

[in, optional] error

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

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

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

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

Комментарии

Windows Server 2003 и более ранее: На платформах Windows до Windows Vista эта функция не поддерживается для WS_UDP_CHANNEL_BINDING или WS_HTTP_CHANNEL_BINDING, если канал находится в состоянии WS_CHANNEL_STATE_ACCEPTING и прослушиватель еще не был прерван.

(Сведения о привязках каналов и состояниях каналов см. в перечислениях WS_CHANNEL_BINDING и WS_CHANNEL_STATE .)

Эта функция также не поддерживается для WS_HTTP_CHANNEL_BINDING с WS_CHANNEL_TYPE_REPLY при прерывании канала в состоянии WS_CHANNEL_STATE_OPEN или WS_CHANNEL_STATE_FAULTED. (Сведения о типах каналов см. в перечислении WS_CHANNEL_TYPE .

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

Если канал находится в состоянии WS_CHANNEL_STATE_OPEN , WsAbortChannel приводит к ошибке канала к состоянию WS_CHANNEL_STATE_FAULTED .

Примечание Сведения о том, как пропустить определенное сообщение и сохранить канал открытым, см. в разделе WsAbandonMessage .

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

Требования

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