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

Эта операция отправляет ряд элементов в модуль записи XML.

Синтаксис

HRESULT WsWriteArray(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 const void          *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] writer

Указатель на модуль записи, в котором записываются элементы.

[in] localName

Указатель на localName повторяющегося элемента.

[in] ns

Указатель на пространство имен повторяющегося элемента.

[in] valueType

Тип значения для элементов

array

Пустой указатель на значения, записанные в модуль записи. Размер элементов определяется типом значения.

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

 

[in] arraySize

Общая длина массива в байтах.

[in] itemOffset

Смещение элемента в массиве для записи.

[in] itemCount

Общее количество элементов, записываемых из массива.

[in, optional] error

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

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

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

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

Требования

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