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

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

  • Статья

Считывает указанное количество текстовых символов из средства чтения и возвращает их в кодировке UTF-8.

Синтаксис

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

Параметры

[in] reader

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

bytes

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

[in] maxByteCount

Максимальное число байтов, которое должно быть прочитано.

[out] actualByteCount

Указатель на значение ULONG фактического числа считанных байтов. Это значение может быть меньше, чем maxByteCount, даже если осталось больше байтов. При возврате нуля больше нет байтов.

[in, optional] error

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

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

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

Код возврата Описание
WS_E_INVALID_FORMAT
 Входные данные не были в ожидаемом формате или не имели ожидаемого значения.
WS_E_QUOTA_EXCEEDED
 Превышена квота.

Комментарии

Xml-текст считывается в начальный или конечный элемент. Комментарии пропускаются, а содержимое CDATA обрабатывается аналогично содержимому элементов. Сущности символов преобразуются в неэкранированную форму.

Эта функция может завершиться сбоем по любой из причин, перечисленных в WsReadNode.

Требования

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