Share via

WsAbortServiceProxy 函式 (webservices.h)

  • 發行項

中止 服務 Proxy，並取消服務 Proxy 上任何擱置的 I/O。

語法

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

參數

[in] serviceProxy

表示要中止之服務 Proxy 之WS_SERVICE_PROXY 結構的指標。

[in, optional] error

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

傳回值

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

傳回碼 Description
E_INVALIDARG
 一或多個引數無效。

備註

WsAbortServiceProxy 會根據服務 Proxy 的狀態顯示下列行為， (請參閱 WS_SERVICE_PROXY_STATE 列舉中是否有可能的狀態) ：

  • 如果服務 Proxy 正在開啟且處於WS_SERVICE_PROXY_STATE_OPENING狀態，您可以呼叫 WsAbortServiceProxy 來中止開啟作業。 服務 Proxy 將會取消所有擱置的 I/O，並轉換回WS_SERVICE_PROXY_STATE_CREATED狀態。
  • 如果服務 Proxy 已開啟且處於WS_SERVICE_PROXY_STATE_OPEN狀態， WsAbortServiceProxy 會導致服務 Proxy 中止所有基礎通道，並轉換至WS_SERVICE_PROXY_STATE_FAULTED狀態。 一旦起始中止，服務 Proxy 將不會接受任何新的呼叫。 應用程式可以呼叫 WsCloseServiceProxy 將其關閉
  • 如果服務 Proxy 正在關閉且處於WS_SERVICE_PROXY_STATE_CLOSING狀態，則會中止所有基礎通道，而服務 Proxy 會轉換為WS_SERVICE_PROXY_STATE_CLOSED狀態。

如需使用此函式的範例，請參閱 ServiceCancellationExample。

規格需求

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