WsCreateServiceProxy function

Creates a service proxy with the specified properties.

Syntax

HRESULT WINAPI  WsCreateServiceProxy(
  _In_     const WS_CHANNEL_TYPE          channelType,
  _In_     const WS_CHANNEL_BINDING       channelBinding,
  _In_opt_ 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_opt_ WS_ERROR*                      error
);

Parameters

channelType [in]

A WS_CHANNEL_TYPE enumeration value representing the channel type for the service proxy.

channelBinding [in]

A WS_CHANNEL_BINDING enumeration value representing the channel binding.

securityDescription [in, optional]

A WS_SECURITY_DESCRIPTION structure representing the security description.

properties

An array of WS_PROXY_PROPERTY structures containing optional properties for the service proxy.

The value of this parameter may be NULL, in which case, the propertyCount parameter must be 0 (zero).

propertyCount [in]

The number of properties in the properties array.

channelProperties

An array of WS_CHANNEL_PROPERTY structures containing optional channel properties. The value of this parameter may be NULL, in which case, the channelPropertyCount parameter must be 0 (zero).

Note  Be very careful about modifying the default values for these properties.

 

channelPropertyCount [in]

The number of properties in the channelProperties array.

serviceProxy

On success, a pointer that receives the address of the WS_SERVICE_PROXY structure representing the new service proxy. When you no longer need this structure, you must free it by calling WsFreeServiceProxy.

error [in, optional]

Pointer to a WS_ERROR structure that receives additional error information if the function fails.

Return value

If the function succeeds, it returns NO_ERROR; otherwise, it returns an HRESULT error code.

Requirements