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

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

  • Статья

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

Синтаксис

HRESULT WsCreateListener(
  [in]           WS_CHANNEL_TYPE               channelType,
  [in]           WS_CHANNEL_BINDING            channelBinding,
                 const WS_LISTENER_PROPERTY    *properties,
  [in]           ULONG                         propertyCount,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 WS_LISTENER                   **listener,
  [in, optional] WS_ERROR                      *error
);

Параметры

[in] channelType

Тип канала, который прослушивает прослушиватель. Сведения о типах каналов см. в перечислении WS_CHANNEL_TYPE .

[in] channelBinding

Протокол канала для прослушивателя. Сведения о возможных привязках см. в перечислении WS_CHANNEL_BINDING .

properties

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

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

Сведения о создании пользовательского прослушивателя см. в разделе Примечания.

[in] propertyCount

Число свойств в массиве свойств .

[in, optional] securityDescription

Указатель на структуру WS_SECURITY_DESCRIPTION , указывающую безопасность прослушивателя.

Если вы создаете пользовательский канал (используя значение WS_CUSTOM_CHANNEL_BINDING перечисления WS_CHANNEL_BINDING ), описание безопасности должно иметь значение NULL. См. раздел «Примечания».

listener

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

[in, optional] error

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

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

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

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

Комментарии

При создании пользовательского прослушивателя (с использованием значения WS_CUSTOM_CHANNEL_BINDING перечисления WS_CHANNEL_BINDING ) можно указать только следующие свойства канала:

  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS
(См. перечисление WS_LISTENER_PROPERTY_ID .) Если для создания пользовательского прослушивателя требуются другие начальные свойства, укажите их с помощью свойства WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS.

Чтобы передать сведения о безопасности в реализацию пользовательского прослушивателя, используйте значение WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS перечисления WS_LISTENER_PROPERTY_ID .

Требования

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