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

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

  • Статья

Обрабатывает создание экземпляра кодировщика.

Синтаксис

WS_CREATE_ENCODER_CALLBACK WsCreateEncoderCallback;

HRESULT WsCreateEncoderCallback(
  [in]           void *createContext,
  [in]           WS_WRITE_CALLBACK writeCallback,
  [in]           void *writeContext,
                 void **encoderContext,
  [in, optional] WS_ERROR *error
)
{...}

Параметры

[in] createContext

Объект createContext, указанный в WS_CHANNEL_ENCODER используется во время создания канала.

[in] writeCallback

Функция, которая должна использоваться для записи данных сообщения. Этот обратный вызов следует использовать только в ответ на обратные вызовы WS_ENCODER_START_CALLBACK, WS_ENCODER_ENCODE_CALLBACK и WS_ENCODER_END_CALLBACK .

[in] writeContext

Контекст записи, который должен быть передан в предоставленный WS_WRITE_CALLBACK.

encoderContext

Возвращает экземпляр кодировщика. Это значение будет передано во все обратные вызовы кодировщика.

[in, optional] error

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

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

Эта функция обратного вызова может возвращать одно из этих значений.

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

Комментарии

При необходимости канал создаст экземпляры кодировщика. Каждый экземпляр кодировщика будет вызываться однопоточным способом. Однако один экземпляр кодировщика не должен предполагать, что он будет видеть все сообщения из канала, так как канал может использовать несколько экземпляров кодировщика для обработки сообщений.

Требования

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