WsAbortChannel 函式 (webservices.h)

  • 發行項

取消指定通道的所有擱置 I/O

語法

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

參數

[in] channel

WS_CHANNEL結構的指標，表示要取消 I/O 的通道。

[in, optional] error

WS_ERROR結構的指標，如果函式失敗，則會接收其他錯誤資訊。

傳回值

如果函式成功，它會傳回NO_ERROR;否則，它會傳回 HRESULT 錯誤碼。

傳回碼 描述
WS_E_NOT_SUPPORTED
 如需平臺限制，請參閱一節。
E_INVALIDARG
 一或多個引數無效。

備註

Windows Server 2003 和之前版本： 在 Windows Vista 之前的 Windows 平臺上，如果通道處於WS_CHANNEL_STATE_ACCEPTING狀態且接聽程式尚未中止，則不支援WS_UDP_CHANNEL_BINDING或WS_HTTP_CHANNEL_BINDING此函式。

(如需通道系結和通道狀態的相關資訊，請參閱 WS_CHANNEL_BINDING 和 WS_CHANNEL_STATE 列舉。)

在中止WS_CHANNEL_STATE_OPEN或WS_CHANNEL_STATE_FAULTED狀態的通道時，WS_CHANNEL_TYPE_REPLY也 WS_HTTP_CHANNEL_BINDING不支援此函式。 (如需通道類型的詳細資訊，請參閱 WS_CHANNEL_TYPE 列舉。

您可以針對處於任何狀態的通道呼叫WsAbortChannel，且不會等待擱置 I/O 完成，再中止通道。

如果通道處於 WS_CHANNEL_STATE_OPEN 狀態， WsAbortChannel 會導致通道發生 WS_CHANNEL_STATE_FAULTED狀態的錯誤 。

注意 如需如何略過特定訊息並讓通道保持開啟的資訊，請參閱 WsAbandonMessage 。

 
如果使用有效的參數呼叫，此函式不會因為缺少系統資源等原因而失敗。 不過，請注意開頭某些作業系統版本的限制。

規格需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll