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

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

  • Статья

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

Синтаксис

HRESULT WsReadArray(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 void                *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [out]          ULONG               *actualItemCount,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] reader

Средство чтения, из которого должен считываться массив.

[in] localName

LocalName повторяющегося элемента.

[in] ns

Пространство имен повторяющегося элемента.

[in] valueType

Тип значения, используемый для анализа содержимого каждого элемента.

array

Массив для заполнения проанализированными значениями. Размер элементов массива определяется типом значения. Дополнительные сведения см . в разделе WS_VALUE_TYPE .

[in] arraySize

Размер массива в байтах (не элементы).

[in] itemOffset

Смещение элемента (не байта) в массиве, по которому выполняется чтение.

[in] itemCount

Количество элементов (не байтов), считываемых в массив.

[out] actualItemCount

Фактическое количество прочитанных элементов. Это значение может быть меньше, чем itemCount, даже если осталось больше элементов. Когда возвращается ноль, больше нет элементов.

[in, optional] error

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

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

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

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

Комментарии

Эта функция семантически эквивалентна использованию WsReadStartElement, WsReadValue и WsReadEndElement в цикле, но более эффективна.

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

Требования

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