WsCreateServiceProxyFromTemplate 函数 (webservices.h)
用于从策略模板创建 服务代理 的帮助程序例程。
语法
HRESULT WsCreateServiceProxyFromTemplate(
[in] WS_CHANNEL_TYPE channelType,
const WS_PROXY_PROPERTY *properties,
[in] const ULONG propertyCount,
[in] WS_BINDING_TEMPLATE_TYPE templateType,
void *templateValue,
[in] ULONG templateSize,
[in] const void *templateDescription,
[in] ULONG templateDescriptionSize,
WS_SERVICE_PROXY **serviceProxy,
[in, optional] WS_ERROR *error
);
参数
[in] channelType
表示服务代理的通道类型的 WS_CHANNEL_TYPE 枚举值。
properties
包含服务代理的可选属性 的WS_PROXY_PROPERTY 结构的数组。
此参数的值可以为 NULL，在这种情况下， propertyCount 参数必须为 0 (零) 。
[in] propertyCount
properties 数组中的 属性 数。
[in] templateType
表示用于创建服务代理的模板类型的 WS_BINDING_TEMPLATE_TYPE 枚举值。
有关详细信息，请参阅 备注 。
templateValue
应用程序要创建和填充的可选模板结构。 此模板结构必须与 templateType) 中的输入模板类型 (一致。 当 templateValue 参数为 NULL 时，它等效于初始化为零的相应模板结构。
有关详细信息，请参阅 备注 。
[in] templateSize
templateValue 参数) 模板结构 (的大小（以字节为单位）。
[in] templateDescription
templateValue 的说明。 这必须与 templateType 匹配。
有关详细信息，请参阅 备注 。
[in] templateDescriptionSize
模板说明的大小。
serviceProxy
成功时，一个指针，用于接收表示新服务代理 的WS_SERVICE_PROXY 结构的地址。
如果不再需要此结构，则必须通过调用 WsFreeServiceProxy 来释放它。
[in, optional] error
指向 WS_ERROR 结构的指针，该结构在函数失败时接收其他错误信息。
返回值
如果函数成功，则返回NO_ERROR;否则，它将返回 HRESULT 错误代码。
注解
WsCreateServiceProxyFromTemplate 根据输入策略模板和其他用户输入创建 WS_SERVICE_PROXY 结构。
下表显示了 templateType 值与在 templateValue 和 templateDescription 中使用的相应数据类型之间的映射。
| templateType | templateValue | templateDescription |
|---|---|---|
| WS_HTTP_BINDING_TEMPLATE_TYPE | WS_HTTP_BINDING_TEMPLATE | WS_HTTP_POLICY_DESCRIPTION |
| WS_HTTP_SSL_BINDING_TEMPLATE_TYPE | WS_HTTP_SSL_BINDING_TEMPLATE | WS_HTTP_SSL_POLICY_DESCRIPTION |
| WS_HTTP_HEADER_AUTH_BINDING_TEMPLATE_TYPE | WS_HTTP_HEADER_AUTH_BINDING_TEMPLATE | WS_HTTP_HEADER_AUTH_POLICY_DESCRIPTION |
| WS_HTTP_SSL_HEADER_AUTH_BINDING_TEMPLATE_TYPE | WS_HTTP_SSL_HEADER_AUTH_BINDING_TEMPLATE | WS_HTTP_SSL_HEADER_AUTH_POLICY_DESCRIPTION |
| WS_HTTP_SSL_USERNAME_BINDING_TEMPLATE_TYPE | WS_HTTP_SSL_USERNAME_BINDING_TEMPLATE | WS_HTTP_SSL_USERNAME_POLICY_DESCRIPTION |
| WS_HTTP_SSL_KERBEROS_APREQ_BINDING_TEMPLATE_TYPE | WS_HTTP_SSL_KERBEROS_APREQ_BINDING_TEMPLATE | WS_HTTP_SSL_KERBEROS_APREQ_POLICY_DESCRIPTION |
| WS_TCP_BINDING_TEMPLATE_TYPE | WS_TCP_BINDING_TEMPLATE | WS_TCP_POLICY_DESCRIPTION |
| WS_TCP_SSPI_BINDING_TEMPLATE_TYPE | WS_TCP_SSPI_BINDING_TEMPLATE | WS_TCP_SSPI_POLICY_DESCRIPTION |
| WS_TCP_SSPI_USERNAME_BINDING_TEMPLATE_TYPE | WS_TCP_SSPI_USERNAME_BINDING_TEMPLATE | WS_TCP_SSPI_USERNAME_POLICY_DESCRIPTION |
| WS_TCP_SSPI_KERBEROS_APREQ_BINDING_TEMPLATE_TYPE | WS_TCP_SSPI_KERBEROS_APREQ_BINDING_TEMPLATE | WS_TCP_SSPI_KERBEROS_APREQ_POLICY_DESCRIPTION |
| WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE | WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE | WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_POLICY_DESCRIPTION |
| WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE | WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE | WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_POLICY_DESCRIPTION |
| WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE | WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE | WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_POLICY_DESCRIPTION |
| WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE | WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE | WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_POLICY_DESCRIPTION |
要求
| 最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | webservices.h |
| Library | WebServices.lib |
| DLL | WebServices.dll |