WS_OPEN_LISTENER_CALLBACK回呼函式 (webservices.h)

  • 發行項

處理WS_CUSTOM_CHANNEL_BINDING的WsOpenListener呼叫。

語法

WS_OPEN_LISTENER_CALLBACK WsOpenListenerCallback;

HRESULT WsOpenListenerCallback(
  [in]           void *listenerInstance,
  [in]           const WS_STRING *url,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

參數

[in] listenerInstance

這個接聽程式實例所建立之狀態的指標，如 WS_CREATE_LISTENER_CALLBACK所建立。

[in] url

要接聽的 URL。 URL 的格式和解譯是由自訂接聽程式所定義。

[in, optional] asyncContext

如何以非同步方式叫用函式的資訊，如果以同步方式叫用，則為 Null 。

[in, optional] error

指定函式失敗時應儲存其他錯誤資訊的位置。

傳回值

傳回碼 描述
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
 一或多個引數無效。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

備註

如需此 API 合約的相關資訊，請參閱 WsOpenListener 。

規格需求

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