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

Вспомогательная процедура для создания конечной точки службы (WS_SERVICE_ENDPOINT) на основе шаблонов политик.

Синтаксис

HRESULT WsCreateServiceEndpointFromTemplate(
  [in]           WS_CHANNEL_TYPE                    channelType,
  [in]           const WS_SERVICE_ENDPOINT_PROPERTY *properties,
  [in]           ULONG                              propertyCount,
  [in, optional] const WS_STRING                    *addressUrl,
  [in]           const WS_SERVICE_CONTRACT          *contract,
  [in]           WS_SERVICE_SECURITY_CALLBACK       authorizationCallback,
  [in]           WS_HEAP                            *heap,
  [in]           WS_BINDING_TEMPLATE_TYPE           templateType,
  [in]           void                               *templateValue,
  [in]           ULONG                              templateSize,
  [in]           const void                         *templateDescription,
  [in]           ULONG                              templateDescriptionSize,
  [out]          WS_SERVICE_ENDPOINT                **serviceEndpoint,
  [in, optional] WS_ERROR                           *error
);

Параметры

[in] channelType

Значение перечисления WS_CHANNEL_TYPE , представляющее тип канала, размещенного конечной точкой.

[in] properties

Массив структур WS_SERVICE_ENDPOINT_PROPERTY , содержащих свойства для конечной точки службы. (Приложение должно заполнить свойства канала в структуре шаблона.)

[in] propertyCount

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

[in, optional] addressUrl

URL-адрес, по которому конечная точка будет прослушивать.

[in] contract

Структура WS_SERVICE_CONTRACT , представляющая контракт конечной точки.

[in] authorizationCallback

Обратный вызов авторизации WS_SERVICE_SECURITY_CALLBACK для конечной точки службы.

[in] heap

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

[in] templateType

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

[in] templateValue

Необязательная структура шаблона для создания и заполнения приложением. Шаблон должен быть согласован с типом входного шаблона (передается в параметре templateType ). Если параметр templateValue имеет значение NULL, это эквивалентно соответствующей структуре шаблона, инициализированной нулю.

[in] templateSize

Размер (в байтах) входной структуры templateValue.

[in] templateDescription

Описание структуры шаблона (передается в параметре templateValue ). Должен соответствовать templateType.

[in] templateDescriptionSize

Размер описания шаблона.

[out] serviceEndpoint

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

[in, optional] error

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

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

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

Комментарии

WsCreateServiceEndpointFromTemplate создает структуру WS_SERVICE_ENDPOINT из указанных шаблонов политик ввода и дополнительных пользовательских входных данных.

Требования

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