WsAbandonCall function (webservices.h)

Abandons a specified call on the specified service proxy.

Syntax

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

Parameters

[in] serviceProxy

Pointer to a WS_SERVICE_PROXY structure representing the service proxy on which to abandon the call.

[in] callId

ID of the call to abandon. (See the Remarks section.)

[in, optional] error

Pointer to a WS_ERROR structure that receives additional error information if the function fails.

Return value

If the function succeeds, it returns NO_ERROR; otherwise, it returns an HRESULT error code.

Remarks

Calls are identified by a call ID. This call ID is associated with the call by the WS_CALL_PROPERTY_CALL_ID value of the WS_CALL_PROPERTY_ID enumeration.

If the call ID is 0, all pending calls on the service proxy are abandoned. For more information, see the following topics:

• Client Side Service Operations
• CallAbandonExample

Be aware that the actual I/O associated with the call is not canceled. The service proxy keeps the resources to complete the call even though the call was abandoned.

This results in a consumption of resources that is aggravated if an application continues to abandon calls, as can happen when the server is slow to respond to the client, and the client application abandons one call only to make the same call again.

Requirements