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

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

  • Статья

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

Синтаксис

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

Параметры

[in] listener

Указатель на структуру WS_LISTENER , представляющую прослушиватель, для которого создается канал. Прослушиватель может находиться в любом состоянии. (Сведения о состояниях прослушивателя см. в перечислении WS_LISTENER_STATE .)

properties

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

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

[in] propertyCount

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

channel

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

[in, optional] error

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

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

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

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

Комментарии

Чтобы принять обмен входящими сообщениями, вызовите функцию WsAcceptChannel .

Характеристики безопасности канала совпадают с характеристиками, указанными для прослушивателя.

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

  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
Если для создания настраиваемого канала требуются начальные свойства, укажите их с помощью свойства WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS.

Требования

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