Функция 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