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

Статья
08/27/2023

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

Синтаксис

WS_CREATE_LISTENER_CALLBACK WsCreateListenerCallback;

HRESULT WsCreateListenerCallback(
  [in]           WS_CHANNEL_TYPE channelType,
                 const void *listenerParameters,
  [in]           ULONG listenerParametersSize,
                 void **listenerInstance,
  [in, optional] WS_ERROR *error
)
{...}

Параметры

[in] channelType

Тип канала, который прослушивает прослушиватель.

listenerParameters

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

Если свойство WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS не указано, значение будет равно NULL.

[in] listenerParametersSize

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

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

listenerInstance

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

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

[in, optional] error

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

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

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

Требования


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

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