通过

WsAbandonCall 函数 (webservices.h)

  • 项目

放弃对指定 服务代理的指定调用。

语法

HRESULT WsAbandonCall(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in]           ULONG            callId,
  [in, optional] WS_ERROR         *error
);

参数

[in] serviceProxy

指向 WS_SERVICE_PROXY 结构的指针，该结构表示要放弃调用的服务代理。

[in] callId

要放弃的调用的 ID。 （请参见“备注”部分。）

[in, optional] error

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

返回值

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

返回代码 说明
WS_E_INVALID_OPERATION
 服务代理的当前状态对此操作无效。
E_INVALIDARG
 NULL 服务代理已传递给函数。

注解

呼叫由呼叫 ID 标识。 此调用 ID 通过WS_CALL_PROPERTY_ID枚举的WS_CALL_PROPERTY_CALL_ID值与 调用 相关联。

如果呼叫 ID 为 0，则会放弃服务代理上所有挂起的调用。 有关详细信息，请参阅下列主题：

请注意，与调用关联的实际 I/O 不会取消。 即使调用已放弃，服务代理也会保留资源以完成调用。

如果应用程序继续放弃调用，这会导致资源消耗加剧，当服务器对客户端的响应速度缓慢，而客户端应用程序只放弃一次调用以再次进行相同的调用时，可能会发生这种情况。

要求

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