通过

WsOpenServiceProxy 函数 (webservices.h)

  • 项目

打开服务终结点的服务代理。

成功后，客户端应用程序可以使用服务代理进行调用。 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

指向要打开 的服务代理 的指针。 指针必须引用有效的 WS_SERVICE_PROXY 对象，并且引用的值可能不是 NULL。

[in] address

指向终结点地址的指针。

[in, optional] asyncContext

指向 WS_ASYNC_CONTEXT 对象的指针，该对象包含有关如何异步调用函数的信息。 如果以同步方式调用，则该值设置为 NULL 。

[in, optional] error

指向 WS_ERROR 对象的指针，如果函数失败，应存储有关错误的其他信息。

返回值

此函数可以返回其中一个值。

返回代码 说明
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 代理服务器拒绝访问。
WS_E_PROXY_FAILURE
 HTTP 代理服务器无法处理请求。
WS_E_QUOTA_EXCEEDED
 超出配额。
WS_E_SECURITY_VERIFICATION_FAILURE
 对于收到的数据，安全验证未成功。
WS_E_SECURITY_SYSTEM_FAILURE
 Windows Web Services 框架中的安全操作失败。
WS_E_PROXY_REQUIRES_BASIC_AUTH
 HTTP 代理服务器需要 HTTP 身份验证方案“basic”。
WS_E_PROXY_REQUIRES_DIGEST_AUTH
 HTTP 代理服务器需要 HTTP 身份验证方案“digest”。
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH
 HTTP 代理服务器需要 HTTP 身份验证方案“协商”。
WS_E_PROXY_REQUIRES_NTLM_AUTH
 HTTP 代理服务器需要 HTTP 身份验证方案“NTLM”。
WS_E_SERVER_REQUIRES_BASIC_AUTH
 远程终结点需要 HTTP 身份验证方案“基本”。
WS_E_SERVER_REQUIRES_DIGEST_AUTH
 远程终结点需要 HTTP 身份验证方案“digest”。
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH
 远程终结点需要 HTTP 身份验证方案“协商”。
WS_E_SERVER_REQUIRES_NTLM_AUTH
 远程终结点需要 HTTP 身份验证方案“NTLM”。
E_OUTOFMEMORY
 内存不足。
E_INVALIDARG
 一个或多个参数无效。
其他错误
此函数可能会返回上面未列出的其他错误。

要求

要求 值
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll