WsAbandonCall 函式 (webservices.h)

放棄指定 服務 Proxy上的指定呼叫。

語法

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

參數

[in] serviceProxy

WS_SERVICE_PROXY結構的指標，表示要放棄呼叫的服務 Proxy。

[in] callId

放棄呼叫的識別碼。 (請參閱＜備註＞一節。)

[in, optional] error

如果函式失敗，WS_ERROR結構的指標，該結構會收到其他錯誤資訊。

傳回值

如果函式成功，它會傳回NO_ERROR;否則會傳回 HRESULT 錯誤碼。

傳回碼	描述
WS_E_INVALID_OPERATION	此作業的服務 Proxy 目前狀態無效。
E_INVALIDARG	Null服務 Proxy 已傳遞至 函式。

備註

呼叫是由呼叫識別碼來識別。 此呼叫識別碼會依WS_CALL_PROPERTY_ID列舉的 WS_CALL_PROPERTY_CALL_ID 值與呼叫相關聯。

如果呼叫識別碼為 0，則會放棄服務 Proxy 上所有擱置的呼叫。 如需詳細資訊，請參閱下列主題：

• 用戶端服務作業
• CallAbandonExample

請注意，不會取消與呼叫相關聯的實際 I/O。 服務 Proxy 會保留資源以完成呼叫，即使已放棄呼叫也一樣。

這會導致當應用程式繼續放棄呼叫時耗用資源，因為伺服器回應用戶端的速度很慢，用戶端應用程式只會放棄一個呼叫，以再次進行相同的呼叫。

規格需求

最低支援的用戶端	Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	webservices.h
程式庫	WebServices.lib
Dll	WebServices.dll