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

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

  • Статья

Записывает байты в модуль записи в формате, оптимизированном для кодировки. При записи в текстовой кодировке он выдает байты, закодированные в base64. При записи в двоичный формат он будет выдавать байты напрямую.

Синтаксис

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Параметры

[in] writer

Модуль записи, в который будут записаны байты.

bytes

Байты для записи в документ.

[in] byteCount

Число байтов для записи в документ.

[in, optional] error

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

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

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

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

Комментарии

WsWriteBytes может вызываться несколько раз между WsWriteStartAttribute и WsWriteEndAttribute. Его нельзя сочетать с WsWriteChars, WsWriteCharsUtf8, WsWriteValue или WsWriteText при написании атрибута.

Для WS_XML_WRITER_MTOM_ENCODING, если значение byteCount превышает значение maxInlineByteCount, указанное в WsSetOutput , байты будут помещены в буфер и помещены в собственную часть MIME. В противном случае байты кодируются в base64 и помещаются непосредственно в документ.

Для WS_XML_WRITER_MTOM_ENCODING, если элемент, содержащий байты, имеет атрибут с именем contentType и пространством имен "http://www.w3.org/2004/11/xmlmime", то значение атрибута будет отражено в заголовке типа контента для части MIME, как описано в статье Оптимизированная xml-двоичная упаковка.

Требования

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