WsCloseServiceProxy 函数 (webservices.h)

  • 项目

关闭与指定 服务代理的通信。

语法

HRESULT WsCloseServiceProxy(
  [in]           WS_SERVICE_PROXY       *serviceProxy,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

参数

[in] serviceProxy

指向表示要关闭的服务代理 的WS_SERVICE_PROXY 结构的指针。

[in, optional] asyncContext

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

[in, optional] error

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

返回值

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

返回代码 说明
WS_S_ASYNC
 异步操作仍处于挂起状态。
WS_E_INVALID_OPERATION
 服务代理的当前状态对此操作无效。 这只是关闭失败的错误。
WS_E_ENDPOINT_DISCONNECTED
 在关闭操作期间，基础 WS_CHANNEL 已断开连接。 此错误仅在基础通道基于会话的情况下发生。
WS_E_OPERATION_ABORTED
 操作已中止。
WS_E_ENDPOINT_FAILURE
 远程终结点无法处理请求。
WS_E_INVALID_FORMAT
 输入数据的格式不是预期的，或者没有预期的值。
WS_E_OPERATION_TIMED_OUT
 该操作未在分配的时间内完成。
WS_E_QUOTA_EXCEEDED
 超出配额。
E_OUTOFMEMORY
 内存不足，无法完成操作。
E_INVALIDARG
 一个或多个参数无效。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

如果服务代理上的服务操作调用挂起， WsCloseServiceProxy 将等待每个调用完成。 调用 WsCloseServiceProxy 后，应用程序不应对服务代理执行任何其他调用。

请注意，WS_E_INVALID_OPERATION是唯一的
指示关闭失败的错误代码。 其他错误代码指示操作成功，错误代码仅供参考。

要求

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