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

функция обратного вызова WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK (webservices.h)

  • Статья

Обрабатывает вызов WsCreateChannelForListener для WS_CUSTOM_CHANNEL_BINDING.

Синтаксис

WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK WsCreateChannelForListenerCallback;

HRESULT WsCreateChannelForListenerCallback(
  [in]           void *listenerInstance,
                 const void *channelParameters,
  [in]           ULONG channelParametersSize,
                 void **channelInstance,
  [in, optional] WS_ERROR *error
)
{...}

Параметры

[in] listenerInstance

Указатель на состояние конкретного экземпляра прослушивателя, созданное WS_CREATE_LISTENER_CALLBACK.

channelParameters

Указатель на значение, указанное свойством WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS при создании настраиваемого канала с помощью WsCreateChannelForListener.

Если свойство WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS не задано, значением будет NULL.

[in] channelParametersSize

Размер в байтах значения, на которое указывает channelParameters.

Если свойство WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS не указано, размер будет равным 0.

channelInstance

Указатель на структуру, выделенную обратным вызовом, которая содержит данные, относящиеся к данному экземпляру канала. Этот указатель будет передаваться во все другие обратные вызовы канала для данного экземпляра канала.

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

[in, optional] error

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

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

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

Комментарии

Сведения о контракте этого API см. в разделе WsCreateChannelForListener .

Требования

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