Función WsCreateServiceProxy (webservices.h)

Artículo
08/27/2023

Crea un proxy de servicio con las propiedades especificadas.

Sintaxis

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

Parámetros

[in] channelType

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

[in] channelBinding

Valor de enumeración WS_CHANNEL_BINDING que representa el enlace de canal.

[in, optional] securityDescription

Estructura WS_SECURITY_DESCRIPTION que representa la descripción de seguridad.

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 .

channelProperties

Matriz de estructuras de WS_CHANNEL_PROPERTY que contienen propiedades de canal opcionales. El valor de este parámetro puede ser NULL, en cuyo caso, el parámetro channelPropertyCount debe ser 0 (cero).

Nota Tenga mucho cuidado con la modificación de los valores predeterminados para estas propiedades.

[in] channelPropertyCount

Número de propiedades de la matriz channelProperties .

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.

Código devuelto	Descripción
E_INVALIDARG	Uno o más argumentos no son válidos.
E_OUTOFMEMORY	Memoria insuficiente para completar la operación.
Otros errores	Esta función puede devolver otros errores no enumerados anteriormente.

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