WsCreateServiceProxy 函数 (webservices.h)

  • 项目

创建具有指定属性 的服务代理 。

语法

HRESULT WsCreateServiceProxy(
  [in]           const WS_CHANNEL_TYPE         channelType,
  [in]           const WS_CHANNEL_BINDING      channelBinding,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 const WS_PROXY_PROPERTY       *properties,
  [in]           const ULONG                   propertyCount,
                 const WS_CHANNEL_PROPERTY     *channelProperties,
  [in]           const ULONG                   channelPropertyCount,
                 WS_SERVICE_PROXY              **serviceProxy,
  [in, optional] WS_ERROR                      *error
);

参数

[in] channelType

表示服务代理的通道类型的 WS_CHANNEL_TYPE 枚举值。

[in] channelBinding

表示通道绑定 的WS_CHANNEL_BINDING 枚举值。

[in, optional] securityDescription

表示安全说明 的WS_SECURITY_DESCRIPTION 结构。

properties

包含服务代理的可选属性 的WS_PROXY_PROPERTY 结构的数组。

此参数的值可以为 NULL，在这种情况下， propertyCount 参数必须为 0 (零) 。

[in] propertyCount

properties 数组中的 属性 数。

channelProperties

包含可选通道属性 的WS_CHANNEL_PROPERTY 结构的数组。 此参数的值可以为 NULL，在这种情况下， channelPropertyCount 参数必须为 0 (零) 。

注意 在修改这些属性的默认值时要非常小心。
 

[in] channelPropertyCount

channelProperties 数组中的属性数。

serviceProxy

成功时，一个指针，用于接收表示新服务代理 的WS_SERVICE_PROXY 结构的地址。

如果不再需要此结构，则必须通过调用 WsFreeServiceProxy 来释放它。

[in, optional] error

指向 WS_ERROR 结构的指针，该结构在函数失败时接收其他错误信息。

返回值

如果函数成功，则返回NO_ERROR;否则，它将返回 HRESULT 错误代码。

返回代码 说明
E_INVALIDARG
 一个或多个参数无效。
E_OUTOFMEMORY
 内存不足，无法完成操作。
其他错误
此函数可能会返回上面未列出的其他错误。

要求

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