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

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

  • Статья

Устанавливает обратный вызов для записи байтов в элементе . В некоторых кодировках это может быть более эффективным, если исключить копию данных.

Синтаксис

HRESULT WsPushBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PUSH_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

Параметры

[in] writer

Указатель на объект модуля записи XML, в который записываются байты. Указатель должен ссылаться на допустимый WS_XML_WRITER и указанное значение не может иметь значение NULL.

[in] callback

Этот параметр является обратным вызовом для записи данных.

[in, optional] callbackState

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

[in, optional] error

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

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

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

Код возврата Описание
E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
WS_E_INVALID_OPERATION
 Операция не разрешена из-за текущего состояния объекта .

Комментарии

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

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

Требования

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