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
WS_S_ASYNC
 異步操作仍在擱置中。
WS_E_OPERATION_ABORTED
 作業已中止。
WS_E_INVALID_OPERATION
 由於物件的目前狀態，不允許此作業。
WS_E_ENDPOINT_NOT_FOUND
 遠端端點不存在或無法找到。
WS_E_ENDPOINT_ACCESS_DENIED
 遠端端點拒絕存取。
WS_E_ENDPOINT_DISCONNECTED
 與遠端端點的連線已終止。
WS_E_ENDPOINT_FAILURE
 遠端端點無法處理要求。
WS_E_ENDPOINT_NOT_AVAILABLE
 遠端端端點目前不在此位置的服務中。
WS_E_ENDPOINT_TOO_BUSY
 遠端端點因為多載而無法處理要求。
WS_E_ENDPOINT_UNREACHABLE
 無法連線到遠端端端點。
WS_E_INVALID_ENDPOINT_URL
 端點位址 URL 無效。
WS_E_INVALID_FORMAT
 輸入數據不是預期的格式，或沒有預期的值。
WS_E_OPERATION_TIMED_OUT
 作業未在配置的時間內完成。
WS_E_PROXY_ACCESS_DENIED
 HTTP Proxy 伺服器拒絕存取。
WS_E_PROXY_FAILURE
 HTTP Proxy 伺服器無法處理要求。
WS_E_QUOTA_EXCEEDED
 超過配額。
WS_E_SECURITY_VERIFICATION_FAILURE
 已接收數據的安全性驗證未成功。
WS_E_SECURITY_SYSTEM_FAILURE
 Windows Web 服務架構中的安全性作業失敗。
WS_E_PROXY_REQUIRES_BASIC_AUTH
 HTTP Proxy 伺服器需要 HTTP 驗證配置 'basic'。
WS_E_PROXY_REQUIRES_DIGEST_AUTH
 HTTP Proxy 伺服器需要 HTTP 驗證配置 'digest'。
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH
 HTTP Proxy 伺服器需要 HTTP 驗證配置 'negotiate'。
WS_E_PROXY_REQUIRES_NTLM_AUTH
 HTTP Proxy 伺服器需要 HTTP 驗證配置 'NTLM'。
WS_E_SERVER_REQUIRES_BASIC_AUTH
 遠端端端點需要 HTTP 驗證配置 'basic'。
WS_E_SERVER_REQUIRES_DIGEST_AUTH
 遠端端端點需要 HTTP 驗證配置 'digest'。
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH
 遠端端點需要 HTTP 驗證配置 'negotiate'。
WS_E_SERVER_REQUIRES_NTLM_AUTH
 遠端端端點需要 HTTP 驗證配置 'NTLM'。
E_OUTOFMEMORY
 記憶體不足。
E_INVALIDARG
 一或多個引數無效。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

備註

如果開啟成功，則必須使用 WsCloseChannel 關閉通道，才能釋放通道。

使用 WsCreateChannel 建立通道。

一旦通道開啟至端點，所有與該端點的通訊就會發生。

端點位址及其內容在函式傳回之後就不需要，即使以異步方式 (叫用函式，也可以安全地在堆棧上宣告) 。

此呼叫期間是否實際發生任何 IO 取決於通道類型和其設定。

規格需求

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