WsCreateXmlBuffer 函数 (webservices.h)

  • 项目

创建可用于处理 XML 数据的 XML 缓冲区。

语法

HRESULT WsCreateXmlBuffer(
  [in]           WS_HEAP                      *heap,
                 const WS_XML_BUFFER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_BUFFER                **buffer,
  [in, optional] WS_ERROR                     *error
);

参数

[in] heap

指向 WS_HEAP 结构的指针，该结构表示要从中为返回的 XML 缓冲区分配内存的 堆 。

properties

包含 XML 缓冲区的可选属性 的WS_XML_BUFFER_PROPERTY 结构的数组。

此参数的值可以为 NULL，在这种情况下， propertyCount 参数必须为 0 (零) 。

[in] propertyCount

属性数组中的 属性 数。

buffer

成功时，一个指针，用于接收表示所创建的 XML 缓冲区 的 WS_XML_BUFFER 结构的地址。 重置或释放此缓冲区的堆时，将释放该缓冲区的内存。

XML 缓冲区最初为空。

[in, optional] error

指向 WS_ERROR 结构的指针，该结构在函数失败时接收其他错误信息。

返回值

如果函数成功，则返回NO_ERROR;否则，它将返回 HRESULT 错误代码。

返回代码 说明
E_OUTOFMEMORY
 内存不足，无法完成操作。
E_INVALIDARG
 一个或多个参数无效。

要求

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