WsWriteElement 函数 (webservices.h)

  • 项目

将类型化值编写为 XML 元素。

语法

HRESULT WsWriteElement(
  [in]           WS_XML_WRITER                *writer,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

参数

[in] writer

要向其写入元素的编写器。

[in] elementDescription

指向如何序列化元素的说明的指针。

[in] writeOption

有关如何分配值的信息。 有关详细信息 ，请参阅WS_WRITE_OPTION 。

value

指向要序列化的值的指针。

[in] valueSize

要序列化的值的大小（以字节为单位）。

如果值为 NULL，则大小应为 0。

[in, optional] error

指定函数失败时应存储其他错误信息的位置。

返回值

此函数可以返回其中一个值。

返回代码 说明
WS_E_INVALID_FORMAT
 输入数据未采用预期格式或没有预期值。
E_INVALIDARG
 一个或多个参数无效。
E_OUTOFMEMORY
 内存不足。

注解

此 API 写入与指定值对应的 start 元素、属性、子元素/文本和结束元素。

如果 API 失败，则输入编写器的状态将变为未定义。 如果发生这种情况，只能在编写器上使用的 API 是 WsSetOutput 和 WsSetOutputToBuffer ，用于将编写器返回到可用状态，或 WsFreeWriter 释放编写器。

要求

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