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

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

  • Статья

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

Синтаксис

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

Параметры

[in] reader

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

[in, optional] encoding

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

properties

Массив необязательных свойств средства чтения. См . WS_XML_READER_PROPERTY.

[in] propertyCount

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

bytes

Байты для анализа.

[in] byteCount

Количество байтов для анализа.

[in] heap

Куча, из которой выделяется БУФЕР XML.

xmlBuffer

Здесь возвращается XML-буфер, в который были считаны байты.

[in, optional] error

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

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

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

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

Комментарии

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

После вызова этой функции средство чтения останется в неопределенном состоянии. Однако WsReadXmlBufferFromBytes может снова использоваться с таким средством чтения. В противном случае следует использовать WsSetInput или WsSetInputToBuffer , чтобы вернуть средство чтения в известное состояние, или средство чтения должно быть освобождено с помощью WsFreeReader.

Требования

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