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

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

  • Статья

Использует модуль записи для преобразования WS_XML_BUFFER в закодированный набор байтов.

Синтаксис

HRESULT WsWriteXmlBufferToBytes(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *xmlBuffer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in]           WS_HEAP                      *heap,
                 void                         **bytes,
  [out]          ULONG                        *byteCount,
  [in, optional] WS_ERROR                     *error
);

Параметры

[in] writer

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

[in] xmlBuffer

Буфер XML для записи.

[in, optional] encoding

Кодировка, используемая при создании байтов. Если значение РАВНО NULL, байты будут кодироваться в кодировке utf8.

properties

Массив необязательных свойств модуля записи. См . WS_XML_WRITER_PROPERTY.

[in] propertyCount

Количество свойств.

[in] heap

Куча, из которой выделяются байты.

bytes

Здесь возвращаются созданные байты.

[out] byteCount

Здесь возвращается количество созданных байтов.

[in, optional] error

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

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

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

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

Комментарии

Функция создает все содержимое WS_XML_BUFFER в виде линейного набора байтов, выделенных из указанной кучи в указанной кодировке.

Модуль записи останется в неопределенном состоянии после вызова этой функции. Однако WsWriteXmlBufferToBytes может снова использоваться с таким модулем записи. В противном случае следует использовать WsSetOutput или WsSetOutputToBuffer для возврата модуля записи в известное состояние, или средство записи должно быть освобождено с помощью WsFreeWriter.

Требования

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