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

Статья
08/27/2023

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

Синтаксис

WS_CREATE_CHANNEL_CALLBACK WsCreateChannelCallback;

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

Параметры

[in] channelType

Шаблон обмена сообщениями канала.

Если тип канала не поддерживается реализацией настраиваемого канала, необходимо вернуть E_INVALIDARG .

channelParameters

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

Если свойство 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	Не хватает памяти.
Другие ошибки	Эта функция может возвращать другие ошибки, не перечисленные выше.

Требования

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

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