Función WsCreateServiceProxyFromTemplate (webservices.h)

Rutina auxiliar para crear un proxy de servicio a partir de plantillas de directiva.

Sintaxis

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
);

Parámetros

[in] channelType

Valor de enumeración WS_CHANNEL_TYPE que representa el tipo de canal para el proxy de servicio.

properties

Matriz de estructuras de WS_PROXY_PROPERTY que contienen propiedades opcionales para el proxy de servicio.

El valor de este parámetro puede ser NULL, en cuyo caso el parámetro propertyCount debe ser 0 (cero).

[in] propertyCount

Número de propiedades de la matriz de propiedades .

[in] templateType

Valor de enumeración WS_BINDING_TEMPLATE_TYPE que representa el tipo de plantillas usadas para crear el proxy de servicio.

Consulte los comentarios para obtener más información.

templateValue

Estructura de plantilla opcional que se va a crear y rellenar mediante una aplicación. Esta estructura de plantilla debe ser coherente con el tipo de plantilla de entrada (en templateType). Cuando el parámetro templateValue es NULL, equivale a la estructura de plantilla correspondiente inicializada en cero.

Consulte los comentarios para obtener más información.

[in] templateSize

Tamaño, en bytes, de la estructura de plantilla (en el parámetro templateValue ).

[in] templateDescription

Descripción de templateValue. Debe coincidir con templateType.

Consulte los comentarios para obtener más información.

[in] templateDescriptionSize

Tamaño de la descripción de la plantilla.

serviceProxy

Si se ejecuta correctamente, un puntero que recibe la dirección de la estructura de WS_SERVICE_PROXY que representa el nuevo proxy de servicio.

Cuando ya no necesite esta estructura, debe liberarla llamando a WsFreeServiceProxy.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Comentarios

WsCreateServiceProxyFromTemplate crea la estructura de WS_SERVICE_PROXY a partir de plantillas de directiva de entrada y entradas de usuario adicionales.

En la tabla siguiente se muestra la asignación entre los valores templateType y los tipos de datos correspondientes que se usarán en templateValue y 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

Requisitos

Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	webservices.h
Library	WebServices.lib
Archivo DLL	WebServices.dll