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 |