WsOpenListener 函式 (webservices.h)

  • 發行項

在指定的位址上起始「接聽」。 一旦開啟接聽程式通道，即可從中接受接聽程式。 如果開啟成功，則必須使用 WsCloseListener 函 式關閉接聽程式，才能釋放接聽程序資源。

語法

HRESULT WsOpenListener(
  [in]           WS_LISTENER            *listener,
  [in]           const WS_STRING        *url,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

參數

[in] listener

要開啟之 Listener 物件的指標。 指標必須參考有效的WS_LISTENER物件 ， 而且參考的值可能不是 NULL。

[in] url

物件的指標，包含接聽程式的URL位址字串。

注意 URL 一律為逸出格式。。 URL 可能不會包含查詢字串或片段。 此 URL 可以在主機名部分或主機名或常值 IP 位址中包含 『+』 或 '*' 通配符。 如需 URL 的詳細資訊，請參閱。
 

[in, optional] asyncContext

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

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_S_ASYNC
 異步操作仍在擱置中。
WS_E_OPERATION_ABORTED
 接聽程式在開啟期間或開啟之前中止。
WS_E_INVALID_OPERATION
 接聽程式處於不正確的狀態。
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
 一或多個引數無效。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

備註

使用 IPv6 位址時，它們必須以括弧括在主機名部分。

如需詳細資訊，請參閱 WS_HTTP_CHANNEL_BINDING。

若 為 WS_UDP_CHANNEL_BINDING，則會忽略URL的路徑部分。 如果指定了常值IP位址，則會使用它來接聽，否則會使用通配符IP位址。

針對 WS_TCP_CHANNEL_BINDING，URL 的路徑部分會比對為所接收 URL 的前置詞。
如果指定了常值IP位址，則會使用它來接聽，否則會使用通配符IP位址。

規格需求

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