WsOpenChannel 函式 (webservices.h)
開啟端點的通道。
語法
HRESULT WsOpenChannel(
[in] WS_CHANNEL *channel,
[in] const WS_ENDPOINT_ADDRESS *endpointAddress,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
參數
[in] channel
要開啟的通道。
[in] endpointAddress
端點的位址。
[in, optional] asyncContext
如何以異步方式叫用函式的資訊,如果以同步方式叫用,則為 NULL 。
[in, optional] error
指定函式失敗時應儲存其他錯誤資訊的位置。
傳回值
此函式可以傳回下列其中一個值。
傳回碼 | Description |
---|---|
|
異步操作仍在擱置中。 |
|
作業已中止。 |
|
由於物件的目前狀態,不允許此作業。 |
|
遠端端點不存在或無法找到。 |
|
遠端端點拒絕存取。 |
|
與遠端端點的連線已終止。 |
|
遠端端點無法處理要求。 |
|
遠端端端點目前不在此位置的服務中。 |
|
遠端端點因為多載而無法處理要求。 |
|
無法連線到遠端端端點。 |
|
端點位址 URL 無效。 |
|
輸入數據不是預期的格式,或沒有預期的值。 |
|
作業未在配置的時間內完成。 |
|
HTTP Proxy 伺服器拒絕存取。 |
|
HTTP Proxy 伺服器無法處理要求。 |
|
超過配額。 |
|
已接收數據的安全性驗證未成功。 |
|
Windows Web 服務架構中的安全性作業失敗。 |
|
HTTP Proxy 伺服器需要 HTTP 驗證配置 'basic'。 |
|
HTTP Proxy 伺服器需要 HTTP 驗證配置 'digest'。 |
|
HTTP Proxy 伺服器需要 HTTP 驗證配置 'negotiate'。 |
|
HTTP Proxy 伺服器需要 HTTP 驗證配置 'NTLM'。 |
|
遠端端端點需要 HTTP 驗證配置 'basic'。 |
|
遠端端端點需要 HTTP 驗證配置 'digest'。 |
|
遠端端點需要 HTTP 驗證配置 'negotiate'。 |
|
遠端端端點需要 HTTP 驗證配置 'NTLM'。 |
|
記憶體不足。 |
|
一或多個引數無效。 |
|
此函式可能會傳回上面未列出的其他錯誤。 |
備註
如果開啟成功,則必須使用 WsCloseChannel 關閉通道,才能釋放通道。
使用 WsCreateChannel 建立通道。
一旦通道開啟至端點,所有與該端點的通訊就會發生。
端點位址及其內容在函式傳回之後就不需要,即使以異步方式 (叫用函式,也可以安全地在堆棧上宣告) 。
此呼叫期間是否實際發生任何 IO 取決於通道類型和其設定。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | webservices.h |
程式庫 | WebServices.lib |
Dll | WebServices.dll |