WsAbortServiceProxy 函数 (webservices.h)

中止服务代理，并取消服务代理上任何挂起的 I/O。

语法

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

[in] serviceProxy

指向表示要中止的服务代理的WS_SERVICE_PROXY 结构的指针。

[in, optional] error

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

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

返回代码	说明
E_INVALIDARG	一个或多个参数无效。

WsAbortServiceProxy 根据服务代理的状态显示以下行为， (查看) 可能状态的WS_SERVICE_PROXY_STATE 枚举：

如果服务代理正在打开并且处于WS_SERVICE_PROXY_STATE_OPENING状态，则可以调用 WsAbortServiceProxy 来中止打开操作。服务代理将取消所有挂起的 I/O，并转换回WS_SERVICE_PROXY_STATE_CREATED状态。
如果服务代理已打开且处于WS_SERVICE_PROXY_STATE_OPEN状态， 则 WsAbortServiceProxy 将导致服务代理中止所有基础通道并转换为WS_SERVICE_PROXY_STATE_FAULTED状态。启动中止后，服务代理将不接受任何新调用。应用程序可以调用 WsCloseServiceProxy 将其关闭
如果服务代理正在关闭并处于WS_SERVICE_PROXY_STATE_CLOSING状态，则所有基础通道都会中止，并且服务代理将转换为WS_SERVICE_PROXY_STATE_CLOSED状态。

有关使用此函数的示例，请参阅 ServiceCancellationExample。