WsAbortListener 函式 (webservices.h)

  • 發行項

取消指定接 聽程式的任何擱置 I/O。

語法

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

參數

[in] listener

表示要取消 I/O 之接聽程式的 WS_LISTENER 結構的指標。

[in, optional] error

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

傳回值

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

備註

當接聽程式處於任何狀態時，可以呼叫 WsAbortListener。 (查看可能狀態 的WS_LISTENER_STATE 列舉。) 如果接聽程式處於WS_LISTENER_STATE_OPEN狀態，此函式會強制接聽程式 (重設為WS_LISTENER_STATE_FAULTED狀態) 。 當接聽程式發生錯誤時，所有嘗試都接受來自該接聽程式的訊息會立即失敗，並出現錯誤碼WS_E_OBJECT_FAULTED。

此函式不會等候擱置的 I/O 完成。

如果使用有效的參數呼叫，此函式不會因為缺少系統資源等原因而失敗。

規格需求

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