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

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

  • Статья

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

Синтаксис

HRESULT WsReadChars(
  [in]           WS_XML_READER *reader,
                 WCHAR         *chars,
  [in]           ULONG         maxCharCount,
  [out]          ULONG         *actualCharCount,
  [in, optional] WS_ERROR      *error
);

Параметры

[in] reader

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

chars

Указатель на расположение прочитанных символов.

[in] maxCharCount

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

[out] actualCharCount

Указатель на значение ULONG фактического числа прочитанных символов. Это значение может быть меньше, чем maxCharCount, даже если осталось больше символов. Если возвращается ноль, больше нет символов.

[in, optional] error

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

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

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

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

Комментарии

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

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

Требования

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