Share via

WsCloseServiceHost 函式 (webservices.h)

  • 發行項

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

語法

HRESULT WsCloseServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

參數

[in] serviceHost

WS_SERVICE_HOST 結構的指標，表示要關閉的服務主機。

[in, optional] asyncContext

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

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_S_ASYNC
 異步操作仍在擱置中。
WS_E_INVALID_OPERATION
 服務主機的目前狀態對此作業無效。
E_INVALIDARG
 一或多個引數無效。
WS_E_OPERATION_TIMED_OUT
 作業未在配置的時間內完成。
WS_E_OPERATION_ABORTED
 作業已中止。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

備註

WsCloseServiceHost 會關閉服務主機上的所有接聽程式。 因此，用戶端不會接受任何新的通道。 不過，允許已接受之通道上的擱置 I/O 完成。

這會影響設定為使用會話型通道系結執行的端點。 如果用戶端在這類端點上具有具有服務的開啟會話，則在用戶端關閉服務會話之前，關閉將不會完成。

規格需求

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