共用方式為


WsOpenServiceProxy 函式 (webservices.h)

開啟服務 Proxy 至服務端點。

在成功用戶端應用程式時,可以使用服務 Proxy 進行呼叫。 WsOpenServiceProxy 的行為是由所使用的 通道系結 所控管。

語法

HRESULT WsOpenServiceProxy(
  [in]           WS_SERVICE_PROXY          *serviceProxy,
  [in]           const WS_ENDPOINT_ADDRESS *address,
  [in, optional] const WS_ASYNC_CONTEXT    *asyncContext,
  [in, optional] WS_ERROR                  *error
);

參數

[in] serviceProxy

要開啟 之服務 Proxy 的指標。 指標必須參考有效的 WS_SERVICE_PROXY 物件,而且參考的值可能不是 NULL

[in] address

端點位址的指標。

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

規格需求

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