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

指向写入 编写器的值的 void 指针。 项的大小由值类型决定。

注意 有关详细信息 ,请参阅WS_VALUE_TYPE

 

[in] arraySize

数组的总字节长度。

[in] itemOffset

要写入的数组中的项偏移量。

[in] itemCount

要从数组写入的项总数。

[in, optional] error

指向 WS_ERROR 对象的指针,如果函数失败,应存储有关错误的其他信息。

返回值

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此函数在语义上等效于在循环中使用 WsWriteStartElementWsWriteValueWsWriteEndElement ,但效率更高。

要求

要求
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll