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 错误代码。
返回代码 | 说明 |
---|---|
|
一个或多个参数无效。 |
|
内存不足,无法完成操作。 |
|
此函数可能会返回上面未列出的其他错误。 |
要求
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | webservices.h |
Library | WebServices.lib |
DLL | WebServices.dll |