Поделиться через

Функция 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

Количество свойств в массиве свойств .

channelProperties

Массив WS_CHANNEL_PROPERTY структур, содержащих необязательные свойства канала. Значение этого параметра может иметь значение NULL. В этом случае параметр channelPropertyCount должен иметь значение 0 (ноль).

Примечание Будьте очень осторожны при изменении значений по умолчанию для этих свойств.
 

[in] channelPropertyCount

Количество свойств в массиве channelProperties .

serviceProxy

При успешном выполнении — указатель, который получает адрес структуры WS_SERVICE_PROXY , представляющей новый прокси-сервер службы.

Если эта структура больше не нужна, ее необходимо освободить, вызвав WsFreeServiceProxy.

[in, optional] error

Указатель на структуру WS_ERROR , которая получает дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Если функция завершается успешно, она возвращает NO_ERROR; в противном случае возвращается код ошибки HRESULT.

Код возврата Описание
E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
E_OUTOFMEMORY
 Недостаточно памяти для завершения операции.
Другие ошибки
Эта функция может возвращать другие ошибки, не перечисленные выше.

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll