Share via

WsOpenServiceHost 函式 (webservices.h)

  • 發行項

開啟 服務主機 進行通訊，並在所有端點上啟動接聽程式。 在呼叫 WsOpenSerivceHost 之前，用戶端應用程式無法連線到服務端點。

語法

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

參數

[in] serviceHost

要開啟 之 Service Host 物件的指標。 指標必須參考 WsCreateServiceHost 所傳回的有效WS_SERVICE_HOST對象，參考的服務主機值可能不是 NULL。

[in, optional] asyncContext

WS_ASYNC_CONTEXT 物件的指標，其中包含如何異步叫用函式的相關信息。 如果以同步方式叫用，此值會設定為 NULL 。

[in, optional] error

WS_ERROR 物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

此函式可以傳回其中一個值。

傳回碼 Description
WS_S_ASYNC
 異步操作仍然擱置中。
WS_E_OPERATION_ABORTED
 服務主機在開啟之前或開啟期間中止。
WS_E_INVALID_OPERATION
 此作業的服務 Proxy 目前狀態無效。
WS_E_ADDRESS_IN_USE
 已使用位址。
WS_E_ADDRESS_NOT_AVAILABLE
 此位址對這個內容無效。
WS_E_QUOTA_EXCEEDED
 超過配額。
WS_E_OPERATION_ABORTED
 作業已中止。
WS_E_OPERATION_TIMED_OUT
 作業未在配置的時間內完成。
E_OUTOFMEMORY
 記憶體不足。
E_INVALIDARG
 一或多個引數無效。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

備註

請注意，所有端點接聽程式都必須在服務主機接受任何通道之前成功開啟，才能與客戶端通訊。

規格需求

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