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
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll