Функция WsCreateServiceProxy (webservices.h)

Статья
08/27/2023

Создает прокси-сервер службы с указанными свойствами.

Синтаксис

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

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