Share via

WsCloseServiceProxy 函式 (webservices.h)

  • 發行項

關閉與指定 之服務 Proxy的通訊。

語法

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

參數

[in] serviceProxy

WS_SERVICE_PROXY結構的指標，代表要關閉的服務 Proxy。

[in, optional] asyncContext

WS_ASYNC_CONTEXT 結構的指標 ，其中包含非同步叫用函式的資訊。 傳遞 Null 以同步叫用函式。

[in, optional] error

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

傳回值

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

傳回碼 描述
WS_S_ASYNC
 非同步作業仍然擱置中。
WS_E_INVALID_OPERATION
 此作業的服務 Proxy 目前狀態無效。 這只是關閉失敗的錯誤。
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
 一或多個引數無效。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

備註

如果服務 Proxy 上的服務作業呼叫擱置中， WsCloseServiceProxy 會等候每個呼叫完成。 呼叫 WsCloseServiceProxy 應用程式之後，不應該在服務 Proxy 上執行任何其他呼叫。

請注意，WS_E_INVALID_OPERATION是唯一的
錯誤碼，表示關閉失敗。 其他錯誤碼表示作業成功，而且錯誤碼僅供參考之用。

規格需求

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