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 错误代码。
注解
此函数在语义上等效于在循环中使用 WsWriteStartElement、 WsWriteValue 和 WsWriteEndElement ,但效率更高。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | webservices.h |
Library | WebServices.lib |
DLL | WebServices.dll |