通过

WsCloseListener 函数 (webservices.h)

  • 项目

导致指定的 侦听器 停止侦听。

语法

HRESULT WsCloseListener(
  [in]           WS_LISTENER            *listener,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

参数

[in] listener

指向表示要关闭的侦听器 的WS_LISTENER 结构的指针。

[in, optional] asyncContext

指向 WS_ASYNC_CONTEXT 结构的指针，该结构包含用于异步调用函数的信息。 传递 NULL 以同步调用函数。

[in, optional] error

指向 WS_ERROR 结构的指针，该结构在函数失败时接收其他错误信息。

返回值

如果函数成功，则返回NO_ERROR;否则，它将返回 HRESULT 错误代码。

返回代码 说明
WS_S_ASYNC
 异步操作仍处于挂起状态。
WS_E_OPERATION_ABORTED
 当侦听器关闭时，对 WsAbortListener 的调用中止了关闭。
WS_E_INVALID_OPERATION
 侦听器处于不适当的状态。
WS_E_OPERATION_TIMED_OUT
 操作未在分配的时间内完成。
E_INVALIDARG
 一个或多个参数无效。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

关闭侦听器后，可以安全地释放侦听器。

对于 处于WS_LISTENER_STATE_OPEN 或 WS_LISTENER_STATE_FAULTED 状态的侦听器，允许此操作。 (有关侦听器状态，请参阅 WS_LISTENER_STATE 枚举。)

当侦听器关闭时，将中止任何使用 WsAcceptChannel 方法接受通道的挂起尝试。 但是， WsCloseListener 会等待任何挂起的 I/O 完成，然后再继续结束过程。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll