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

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

  • Статья

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

Синтаксис

HRESULT WsCreateServiceProxyFromTemplate(
  [in]           WS_CHANNEL_TYPE          channelType,
                 const WS_PROXY_PROPERTY  *properties,
  [in]           const ULONG              propertyCount,
  [in]           WS_BINDING_TEMPLATE_TYPE templateType,
                 void                     *templateValue,
  [in]           ULONG                    templateSize,
  [in]           const void               *templateDescription,
  [in]           ULONG                    templateDescriptionSize,
                 WS_SERVICE_PROXY         **serviceProxy,
  [in, optional] WS_ERROR                 *error
);

Параметры

[in] channelType

Значение перечисления WS_CHANNEL_TYPE , представляющее тип канала для прокси-сервера службы.

properties

Массив структур WS_PROXY_PROPERTY , содержащих необязательные свойства прокси-сервера службы.

Значение этого параметра может иметь значение NULL. В этом случае параметр propertyCount должен иметь значение 0 (ноль).

[in] propertyCount

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

[in] templateType

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

Дополнительные сведения см. в разделе Примечания .

templateValue

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

Дополнительные сведения см. в разделе Примечания .

[in] templateSize

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

[in] templateDescription

Описание templateValue. Он должен соответствовать templateType.

Дополнительные сведения см. в разделе Примечания .

[in] templateDescriptionSize

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

serviceProxy

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

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

[in, optional] error

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

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

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

Комментарии

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

В следующей таблице показано сопоставление между значениями templateType и соответствующими типами данных, которые будут использоваться в templateValue и templateDescription.

TemplateType templateValue TemplateDescription
WS_HTTP_BINDING_TEMPLATE_TYPE WS_HTTP_BINDING_TEMPLATE WS_HTTP_POLICY_DESCRIPTION
WS_HTTP_SSL_BINDING_TEMPLATE_TYPE WS_HTTP_SSL_BINDING_TEMPLATE WS_HTTP_SSL_POLICY_DESCRIPTION
WS_HTTP_HEADER_AUTH_BINDING_TEMPLATE_TYPE WS_HTTP_HEADER_AUTH_BINDING_TEMPLATE WS_HTTP_HEADER_AUTH_POLICY_DESCRIPTION
WS_HTTP_SSL_HEADER_AUTH_BINDING_TEMPLATE_TYPE WS_HTTP_SSL_HEADER_AUTH_BINDING_TEMPLATE WS_HTTP_SSL_HEADER_AUTH_POLICY_DESCRIPTION
WS_HTTP_SSL_USERNAME_BINDING_TEMPLATE_TYPE WS_HTTP_SSL_USERNAME_BINDING_TEMPLATE WS_HTTP_SSL_USERNAME_POLICY_DESCRIPTION
WS_HTTP_SSL_KERBEROS_APREQ_BINDING_TEMPLATE_TYPE WS_HTTP_SSL_KERBEROS_APREQ_BINDING_TEMPLATE WS_HTTP_SSL_KERBEROS_APREQ_POLICY_DESCRIPTION
WS_TCP_BINDING_TEMPLATE_TYPE WS_TCP_BINDING_TEMPLATE WS_TCP_POLICY_DESCRIPTION
WS_TCP_SSPI_BINDING_TEMPLATE_TYPE WS_TCP_SSPI_BINDING_TEMPLATE WS_TCP_SSPI_POLICY_DESCRIPTION
WS_TCP_SSPI_USERNAME_BINDING_TEMPLATE_TYPE WS_TCP_SSPI_USERNAME_BINDING_TEMPLATE WS_TCP_SSPI_USERNAME_POLICY_DESCRIPTION
WS_TCP_SSPI_KERBEROS_APREQ_BINDING_TEMPLATE_TYPE WS_TCP_SSPI_KERBEROS_APREQ_BINDING_TEMPLATE WS_TCP_SSPI_KERBEROS_APREQ_POLICY_DESCRIPTION
WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE WS_HTTP_SSL_USERNAME_SECURITY_CONTEXT_POLICY_DESCRIPTION
WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE WS_HTTP_SSL_KERBEROS_APREQ_SECURITY_CONTEXT_POLICY_DESCRIPTION
WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_BINDING_TEMPLATE WS_TCP_SSPI_USERNAME_SECURITY_CONTEXT_POLICY_DESCRIPTION
WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE_TYPE WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_BINDING_TEMPLATE WS_TCP_SSPI_KERBEROS_APREQ_SECURITY_CONTEXT_POLICY_DESCRIPTION

Требования

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