WsAbortListener 函数 (webservices.h)

  • 项目

取消指定 侦听器的任何挂起 I/O。

语法

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

参数

[in] listener

指向 WS_LISTENER 结构的指针，该结构表示要取消其 I/O 的侦听器。

[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
Library WebServices.lib
DLL WebServices.dll